Skip to content
This repository has been archived by the owner on Jun 13, 2024. It is now read-only.
Alessandro edited this page Apr 21, 2022 · 2 revisions

How to run correctly the extension

  1. Install the extension in your browser via the official link
  2. Download the correct executable for your operating system from the Tropea-Project official website
  3. Run the executable
  4. Enter the exact path to the TorBrowser folder Extension started successfully.

N.B. Be very careful to correctly follow the various syntax of the features that you can find on this page based on the feature of interest

How to get TorBrowser Path

Immediately after starting the executable it is essential to set the correct absolute path of the folder where TorBrowser is contained. If you haven't downloaded TorBrowser yet, you need to do it and you can do it via this link.

  • Example for Linux operating systems:
  1. Go to the folder where TorBrowser was downloaded
  2. Open a terminal and run the command 'tar -xf ' for example, in my case, 'tar -xf tor-browser-linux64-11.0.6_it.tar.xz'
  3. Then navigate inside the folder you just extracted using the 'cd' command for example, in my case, 'cd tor-browser_it/'
  4. Run the command 'pwd'
  5. Copy the command output ..
  • Example for Windows operating systems:
  1. Go to the folder where TorBrowser was installed
  2. Right click on the executable
  3. Ownership
  4. Copy the entry 'path' ..
  • Example for MacOS operating systems:
  1. \ * not available <- Untested \ *

..Open the Tropea-Project extension Paste and press the 'Edit!'

TorBrowser Path

The path you select, relative to the folder containing the TorBrowser launcher, must be complete, here are some examples. If the 'tor-browser' folder containing the TorBrowser launcher and the 'Browser' folder is on the Desktop then the path might look like this:

Windows

C://Users/ale/Desktop/tor-browser/

Linux

/home/ale/Desktop/tor-browser/

MacOS

/home/ale/Desktop/tor-browser/

Once you have acquired the correct path, all you have to do is open the extension and paste the path in the text bar under the heading 'TorBrowser Path', as shown in the picture. Once you click 'Edit!', Assuming that you have successfully started the executable locally, you will see written next to 'Actualpath' the path from you entered.

EntryNodes and StrictNodes

To use this field correctly, you must enter the identification code of the state you want to use as an incoming node in the text space.

If you don't know which is the code of the state you want to use then just google Code -name_of_state- for example Code Switzerland and you will see that as a result you will have CH and, therefore, assuming you want to use Switzerland as an incoming node, just enter the ch code in the text space and then press the Add! button

N.B. If you want to make sure that there are Tor Relays in the state you want to use, then visit this site indicating in the search bar the code of the state you want to check, replacing the one you will find, that is it.

To use the StrictNodes mode, all you have to do is keep the blue tick on the right selected, alternatively just click on it to ensure that the indicated option will not be used.

N.B. The StrictNodes mode forces the EntryNodes command, consequently it will try to forcibly use the indicated node being able to report slowdowns during the connection.

ExitNodes and StrictNodes

To use this field correctly, you must enter the identification code of the state you want to use as an output node in the text space.

If you don't know which is the code of the state you want to use then just google Code -name_of_state- for example Code Switzerland and you will see that as a result you will have CH and, therefore, assuming you want to use Switzerland as an incoming node, just enter the ch code in the text space and then press the Add! button

N.B. If you want to make sure that there are Tor Relays in the state you want to use, then visit this site indicating in the search bar the code of the state you want to check, replacing the one you will find, that is it.

To use the StrictNodes mode, all you have to do is keep the blue tick on the right selected, alternatively just click on it to ensure that the indicated option will not be used.

N.B. The StrictNodes mode forces the ExitNodes command, consequently it will try to forcibly use the indicated node being able to report slowdowns during the connection.

ExcludeNodes

To use this field correctly, you must enter the identification code of the state that you want to exclude in any node of the chain in the text space.

If you don't know which is the code of the state you want to use then just google Code -name_of_state- for example Code Switzerland and you will see that as a result you will have CH and, therefore, assuming you want to use Switzerland as an incoming node, just enter the ch code in the text space and then press the Add! button

N.B. If you want to make sure that there are Tor Relays in the state you want to use, then visit this site indicating in the search bar the code of the state you want to check, replacing the one you will find, that is it.

N.B. In this mode the StrictNodes option is not foreseen since it will be forcedly respected by default.

ExcludeExitNodes

To use this field correctly, you need to enter the identifier code of the state you want to exclude in the ExitNode of the chain in the text space.

If you don't know which is the code of the state you want to use then just google Code -name_of_state- for example Code Switzerland and you will see that as a result you will have CH and, therefore, assuming you want to use Switzerland as an incoming node, just enter the ch code in the text space and then press the Add! button

N.B. If you want to make sure that there are Tor Relays in the state you want to use, then visit this site indicating in the search bar the code of the state you want to check, replacing the one you will find, that is it.

N.B. In this mode the StrictNodes option is not foreseen since it will be forcedly respected by default.

GeoIPExcludeUnknow

If this option is set to auto, whenever a country code is set in ExcludeNodes or ExcludeExitNodes, all nodes with unknown country ({??}) are also treated as excluded. If this option is set to yes, all unknown countries are treated as excluded in ExcludeNodes and ExcludeExitNodes.

This default field returns the value auto.

Torify

Description

torify is a Tor feature that allows you to use the tor network not only with browsers like TorBrowser but also with other applications. Unfortunately this project is still under construction and therefore does not provide full functionality in any operating system, in fact on Windows systems it does not work and on MacOS / Linux systems it does not work with all applications.

Attention!

Make sure you use this functionality with the applications indicated in this list since, as reported in this thread on the official Tor forum, unfortunately it cannot be used with any application.

Description-Tech

torify is a simple command that tries to use the protocol used by the Tor network to encrypt connections in applications by calling torsocks or tsocks with a tor-specific configuration file. torsocks is a command that explicitly rejects UDP, securely resolves DNS lookups, and properly blocks your TCP connections. tsocks itself is a wrapper between the tsocks library and the application you want to run socksified. Note that since both methods use LD_PRELOAD, torify cannot be applied to suid binaries.

Attention-Tech

You should also be aware that the way tsocks currently works only TCP connections are socksified. Note that in most cases this will not include host name lookups which would still be routed through the normal system resolver to the usual resolution name servers. The tor-resolve tool can be useful as a workaround in some cases. The Tor FAQ at https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ may have more information on this topic. When used with torsocks, torify should not lose DNS requests or UDP data. Both will lose ICMP data.

Settings

To remove the settings previously entered via the extension, or simply to view all the settings already set, just go to the Advanced-Tropea home page and go down to the Tropea Settings section.

It is essential to keep the local script open and it is equally essential to have correctly set the TorBrowser path before being able to view the extension, if you do not see anything then it means that at least one of the two operations is not been correctly carried out.