Skip to content

README.md

Latest commit

 

History

History
68 lines (43 loc) · 3.05 KB

README.md

File metadata and controls

68 lines (43 loc) · 3.05 KB

BitslabSafe

BitslabSafe is a browser extension focused on social media and web safety. It provides real-time risk detection and site blocking to protect your browsing experience.

Features

  • Link risk warnings in X/Twitter posts: analyze external links in timelines and tweet detail pages and mark risky destinations
  • Dangerous site blocking: automatically block suspected phishing, malicious, or impersonation sites with clear reasons
  • X/Twitter account analysis: highlight suspicious behavior and potential impersonation risks to help identify untrustworthy accounts
  • Lightweight and privacy-friendly: local-first detection flows with minimal data collection

Visit the product site for more details: https://safe.bitslab.xyz/

Installation and Use

Supported primarily on Chromium-based browsers (Chrome, Edge, Brave, etc.).

Manual install (developer mode):

  1. Download a release package or build output and unzip
  2. Open chrome://extensions and enable "Developer mode"
  3. Click "Load unpacked" and select the unzipped extension directory (typically dist/ or your build output directory)

Usage:

  • On X/Twitter, the extension automatically shows link risk warnings in posts
  • When a high-risk website is detected, the extension shows a blocking page with detailed reasons
  • Click the extension icon in the browser toolbar to view recent analyses and common settings

Permissions

Depending on implementation and browser version, the extension may request:

  • Page access and content scripts (to display warnings on X/Twitter pages)
  • Network request observation and interception (for site risk decisions and blocking)
  • Local storage (to save user preferences and cache detection results)
  • Notifications (to alert users of security events when necessary)

Privacy and Data

  • Does not collect personally identifiable information and does not read sensitive credentials
  • Uses local-first detection; contacts BitsLab security cloud only when needed for up-to-date intelligence
  • Any collected risk signals are used solely to improve security detection, not for ads or profiling

Development and Build

This repository contains a browser extension. For local development and building:

  • Ensure a modern Node.js runtime is installed
  • Install dependencies and run your build scripts to produce a loadable extension directory
  • For detailed developer guidance, see: https://safe.bitslab.xyz/

Build scripts and configuration differ by environment and browser; follow the actual repository scripts.

FAQ

  • No warnings shown on X/Twitter: confirm the extension is enabled and allowed on x.com/twitter.com
  • False positives or misses: submit feedback in the blocking page or popup, or via the product website
  • Conflicts with other security extensions: adjust rule priority in settings or temporarily disable conflicting extensions to isolate issues

Support

License

This project is licensed under the MIT License. See the LICENSE file in this repository.