chr3st5an / tracer

Tracer is an OSINT tool that can be used to detect on which websites a username is currently in use

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)

tracer's Issues

He

Hudson Rock Cybercrime Intelligence Free Integration

Consider adding Hudson Rock's complimentary data to receive additional intelligence about a username that was compromised in global Infostealer attacks.

Username sample: https://cavalier.hudsonrock.com/api/json/v2/osint-tools/search-by-username?username=testadmin

Free API key and full documentation is available here: https://cavalier.hudsonrock.com/docs

Thank you.

Cher

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

[DETECTION ISSUE]

Which website is involved
The involved website

Did you use a VPN / Proxy
Software that obfuscated your IP address

Does the username contain non-ascii characters
Non-ascii characters are for example emojis

How long is the username
The amount of characters that the username contains

Did it work before
Did Tracer suddenly report a false result