https://github.com/censortracker/censortracker
Censor Tracker is a censorship circumvention extension for Google Chrome and Mozilla Firefox.
https://github.com/censortracker/censortracker
addon brave censorship censortracker chrome chromium dpi-filtering firefox firefox-addon microsoft-edge mozilla proxy shadowsocks vless vmess webextension xray-core
Last synced: 8 days ago
JSON representation
Censor Tracker is a censorship circumvention extension for Google Chrome and Mozilla Firefox.
- Host: GitHub
- URL: https://github.com/censortracker/censortracker
- Owner: censortracker
- License: mit
- Created: 2020-05-26T07:35:10.000Z (almost 5 years ago)
- Default Branch: stable
- Last Pushed: 2025-04-01T14:16:16.000Z (22 days ago)
- Last Synced: 2025-04-07T05:01:38.497Z (16 days ago)
- Topics: addon, brave, censorship, censortracker, chrome, chromium, dpi-filtering, firefox, firefox-addon, microsoft-edge, mozilla, proxy, shadowsocks, vless, vmess, webextension, xray-core
- Language: HTML
- Homepage: https://censortracker.org/
- Size: 41.6 MB
- Stars: 652
- Watchers: 11
- Forks: 45
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Censor Tracker is a powerful censorship circumvention browser extension.
In addition, it enables the use of custom proxies and supports Vless,
Vmess, and Shadowsocks in the browser via an external client called Censor Tracker Proxy.
Features
========
Censor Tracker offers a range of useful features, including:
- Configurable proxy settings
- Country-specific proxy routing
- Customizable proxy and exclusion lists
- Built-in resistance to censorship
- Warnings for websites that share user data with third parties
- Support `Vless`, `Vmess` and `Shadowsocks` proxies ([Censor Tracker Proxy](https://github.com/censortracker/proxy) is
required)
Permissions
===========
Censor Tracker requires the following permissions:
- `alarms` — Enables periodic tasks such as database synchronization and re-requesting the list of proxy servers.
- `activeTab` — Detects IDO websites (primarily relevant for Russian users).
- `management` — Identifies permission conflicts (e.g., with other extensions).
- `notifications` — Displays notifications.
- `proxy` — Configures and utilizes Censor Tracker proxy servers.
- `storage` — Saves user preferences.
- `unlimitedStorage` — Stores the database of blocked websites (due to its large size).
- `webNavigation` — Manages and monitors web requests.
- `http://*/*` and `https://*/*` — Allows website proxying, retrieval of proxy server lists, and user country
detection (required for country-specific proxying).
Requirements
============
Censor Tracker works with following versions of browsers:
- Mozilla Firefox 98 or higher
- Chromium (Google Chrome, Brave, Edge, Opera etc.) 94 or higher
Development
===========
Make sure you have required versions of `node` and `npm`, which are:
- `node v17.4.0` or higher
- `npm 8.3.1` or higher
Optionally, you may like:
- [`nvm`](https://github.com/nvm-sh/nvm)
Firstly, you will need to install dependencies:
~ npm install
Now you can build an extension for Chrome like this:
~ npm run build:chrome
~ cd dist/chrome
and for Firefox, like this:
~ npm run build:firefox
~ cd dist/firefox
**Troubleshooting**: If you're getting error on building an extension using `npm`, please make sure that your
shell supports per-command environment variables (i.e something like this
`NODE_ENV=production npm run build:firefox:prod`)
License
=======
Censor Tracker is licensed under the MIT License. See [LICENSE] for more
information.
[LICENSE]: https://github.com/censortracker/censortracker/blob/master/LICENSE