Tracer

Tracer detects on which website a username is currently in use!

Official Repository · Report Bug

Features

---

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

(Beam me up)

Built With

---

• 

• 

Getting Started

---

Prerequisites

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"

(Beam me up)

Installation

1. Clone this repository

git clone https://github.com/chr3st5an/tracer.git

🛈 If you do not have git, you can download this repository by clicking on Code > Download ZIP. Unzip the folder and open a terminal.

2. Navigate into the just downloaded folder

cd tracer/

3. Install dependencies

pip install -r ./requirements.txt

(Beam me up)

Usage

---

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.

(Beam me up)

GUI

---

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.

(Beam me up)

Options

---

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

(Beam me up)

License

---

This project is licensed under the MIT license. For more information check out the project's license file.

(Beam me up)