Lightweight Firefox extension for enabling/disabling Tor proxy connection.
Torium is a lightweight Firefox extension that gives you one-click control over your Tor proxy connection. No need to dig through browser settings or reconfigure your system manually — simply click the icon in your toolbar to route your traffic through Tor or revert to your normal connection instantly.
Before installing the extension, make sure the following are set up on your system:
1. Tor
Tor must be installed and running locally. It exposes a SOCKS5 proxy on 127.0.0.1:9050 by default.
- Windows: Download the Tor Expert Bundle and run
tor.exe - macOS:
brew install tor && brew services start tor - Linux:
sudo apt install tor && sudo systemctl start tor
Verify Tor is running before using the extension.
2. Torium Extension
Install the extension from the Releases section below.
- Go to the Releases page of this repository.
- Download the latest
.xpifile. - Open Firefox and navigate to
about:addons. - Click the gear icon and select Install Add-on From File…
- Select the downloaded
.xpifile and confirm the installation.
The Torium icon will appear in your Firefox toolbar once installed.
| Action | Result |
|---|---|
| Click the toolbar icon | Toggle Tor proxy on or off |
| Green indicator | Tor proxy is active — traffic is routed through Tor |
| Grey indicator | Tor proxy is inactive — using your normal connection |
When Tor is enabled, Firefox will route all browser traffic through 127.0.0.1:9050 (SOCKS5). Disabling it restores your default network settings.
Torium uses the Firefox proxy API to programmatically apply or remove SOCKS5 proxy settings. All configuration is handled locally within the extension — no data is sent to any external server.
- Proxy:
127.0.0.1:9050(SOCKS5) - DNS over proxy: Enabled by default to prevent DNS leaks
- Scope: Applies to all Firefox traffic while active
The extension requests the following permissions:
proxy— Required to configure Firefox's proxy settingsstorage— Saves your toggle state across browser sessionsnotifications(optional) — Displays a brief confirmation when the proxy is toggled
Tor proxy is enabled but pages aren't loading
Make sure the Tor service is actually running on your machine. Run curl --socks5 127.0.0.1:9050 https://check.torproject.org in your terminal to verify connectivity.
The extension icon is missing from the toolbar
Go to about:addons, confirm Torium is enabled, then right-click your Firefox toolbar and select Customize Toolbar to pin the icon.
I see a "proxy server refusing connections" error
Tor may not be listening on port 9050. Check your torrc configuration or restart the Tor service.
I see an error "unable to connect to tor" but torrc is running Check if you've allowed the extension to run in private windows
Contributions, bug reports, and feature requests are welcome. Please open an issue or submit a pull request.
Licensed under GPL v3.