What is "Tor Control" extension and how does it work?
Tor Control add-on aims to bring the power of Tor network to the browser of your choice. The extension adds a toolbar button to your browser and starts Tor in a background tab. By default extensions cannot access any external proress and hence you will be asked to install a minimal NodeJS native client as a bridge to let the extension start and stop a native application (Tor executable). After the first run, open the toolbar panel and press the red "OFF" button. If "Tor Bundle" is not yet set in the options page, extension will ask you to download and extract this package in a local directory. This bundle contains tor executable as well as all the necessary configuration files. You can get the bundle from https://github.com/andy-portmen/tor-bundle/releases. I will try to update the bundle with the latest Tor executable once per while. However you can download the official Tor executable and replace it with the one that is attached in the zip file. Note that do not replace configuration files while updating your Tor executable. After Tor bundle is extracted to a local directory and it's root directory is set in the options page, open the panel one more time and press the red "OFF" button once again. A new tab will open up and ask for native client. This native client is the actual bridge to allow this extension to execute external commands (start and stop a new Tor process). Follow the steps to install the native client. Once native client is installed, hit the "Check Connection" button to make sure native client is installed correctly. At this point all the required modules are ready and you can start using the Tor network by pressing on the red "OFF" button. It usually takes a few minutes for the tor to complete its handshaking process and connect you to the anonymous network. Here is the summery of steps to follow before using the extension:
A browser extension to get notified (desktop notification and sound alarm) of unread emails on one or more search queries. This extension supports multiple accounts and does not require credentials to operate. Read more here.
How can I make sure I am connected to the Tor network?
When the connection button on the panel is pressed, the extension starts a Tor instance and it connects you to the Tor network. You can review the current connection state in the log section. When extension notifies you of a successful connection, go to the panel and click on the verify button to open https://check.torproject.org/ in a browser tab. This will confirm your connection.
Is it possible to change my external IP when I am connected to the Tor network?
Yes, open the panel and press "New Identity" button once. This will ask Tor to request a new exit node and hence a new external IP address.
What's new in this version?
Please check the Logs section.
What is Tor?
Tor is free software for enabling anonymous communication to protect user privacy.
Read https://en.wikipedia.org/wiki/Tor_(anonymity_network) for more information or check the official Tor website.
How can I install the native client?
Instruction on how to install the native client will be displayed once the toolbar button is clicked. If you want to see it in action watch these two short tutorials
Linux and Mac: https://www.youtube.com/watch?v=bB4Bj_APg4g
After installing the native client, on Firefox I get "[err] "proxy.settings" requires private browsing permission" error when I start the extension from the popup. What does this error mean and how can I fix it?
This extension configures your browser proxy and for that, you need to allow the extension to be active in the private mode. Go to the addons manager and active private mode access for this extension and then retry.
When I use this extension, my other WebRTC extension gets disabled. Is this a bug or does the extension have a built-in WebRTC shield?
This extension has an internal WebRTC module that gets enabled when the Tor network is connected. This way the browser is not going to reveal your real IP address. In the Chrome browser, the last installed extension is taking control of privacy settings. So if you have two extensions that want to control WebRTC, only the last installed one is capable of modifying the setting. This is useful to prevent one extension from altering the preferences.
On Mac OS, I get an error message on the popup window when trying to use this tor client. How can I fix this?
On Mac OS, it is recommended to place the extracted directory on the "home" directory (/Users/.../). By placing it on "Downloads" or "Desktop" directories, you might get the "dyld: Library not loaded: @executable_path/...file system sandbox blocked open() of ..." error message. Also, for the first time, you need to run the "tor" executable inside the directory by double-clicking on it. By manually executing the "tor" application, it gets listed as a trusted application, and hence your browser can execute it later. Note that this project uses the official version of the "tor" executable.
There is no official bundle version for Linux OS. Can I still use this extension on my Linux machine?
Since there are many different tor executables on various distributions, this extension does not provide a single bundle for Linux operating system. However, you can install the tor on your distribution from the package manager of your distribution (e.g. apt-get on Ubuntu). Then download the Mac version of the bundle from GitHub, and replaces the tor executable with the symlink to the actual tor executable. Or you can copy the tor executable from a compatible TOR browser package. Read this GitHub thread for more info.
Please keep reviews clean, avoid the use of improper language and do not post any personal information.