Tracer detects on which website a username is currently in use!
Tracer provides the following features:
-
170+ sites that are checked
-
Filter websites based on their domain or category
- Limit the pool of sites that will be checked
-
Browser version (GUI)
-
Save the result of each check in a report file
-
Open successful results in your browser
-
Customizability:
- Use the included config file to change the behavior of Tracer
-
Easy to use
For Tracer to work, you will need Python 3.7 or later and pip. You can download Python from the official website. Python ships with pip. Verify the versions:
- python
python -V
- pip
pip -V # or "python -m pip -V"
- Clone this repository
git clone https://github.com/chr3st5an/tracer.git
๐ If you do not have
git
, you can download this repository by clicking onCode
>Download ZIP
. Unzip the folder and open a terminal.
- Navigate into the just downloaded folder
cd tracer/
- Install dependencies
pip install -r ./requirements.txt
After you installed all dependencies you are ready to run Tracer for the first time ๐ To do so, open a terminal in the project's root folder and run the following command:
python tracer [OPTIONS] username
Where [OPTIONS]
are optional flags you can pass to Tracer to modify its behavior. More about options later.
Tracer also offers a GUI in form of a webapp. You can run the webapp by executing the following command:
python tracer --web tracer
This will run the webapp on port 12345. Tracer should automatically open your browser and connect to the webapp. If not, open your browser manually and type http://127.0.0.1:12345
into the search bar and hit enter.
For a list of all available commands and options, use the -h
flag or read the following section
python tracer -h
Options
-
-h
,--help
print a help message and exit -
-t <timeout>
set a timeout for requests -
-e <domain>
exclude a domain -
-o <domain>
only check this domain for the username -
-O <category>
only check sites that fall under this category for the username -
-E <category>
exclude all sites that fall under this category -
-b
open sites on which the username got found, in your default browser -
-v
print additional information while the program runs -
-a
print all websites -
--web
run a GUI in form of a local webapp -
--ip-check
retrieve your public IP address before starting the main program
This project is licensed under the MIT license. For more information check out the project's license file.