SHERLOCK(1)

📦
version 0.16.0 · 4 versions
, in ubuntu stonking

✨ NAME ✨

okay bestie, so you found sherlock — it's the manual page for sherlock(1), and it does exactly what it says on the tin: it finds usernames across social networks. no cap. 🕵️♀️💖

🌸 SYNOPSIS 🌸

sherlock [POSITION] [argument]

🦋 DESCRIPTION 🦋

lowkey the whole magic trick here is that sherlock depends on the site's designers giving each registered username its own unique URL. that's the entire vibe. 💅

so to figure out if a username is available or not, Sherlock hits that URL, and then reads the response to work out whether there's already a claimed username sitting there. it's giving detective energy fr fr. 🔍

right now, the tool is capable of locating users on more than 300 social networks, and some of the icons on that list are:

  • Apple Developer
  • Arduino
  • Docker Hub
  • GitHub
  • GitLab
  • Facebook
  • BitCoinForum
  • CNET
  • IFTTT
  • Instagram
  • PlayStore
  • PyPI
  • Scribd
  • Telegram
  • TikTok
  • Tinder

etc. (yes, etc. — the list keeps going, bestie 😭👑)

💅 USAGE 💅

here's the usage block, verbatim, so you can screenshot it and put it in the group chat:

usage: sherlock [-h] [--version] [--verbose] [--folderoutput FOLDEROUTPUT]
                [--output OUTPUT] [--tor] [--unique-tor] [--csv]
                [--site SITE_NAME] [--proxy PROXY_URL] [--json JSON_FILE]
                [--timeout TIMEOUT] [--print-all] [--print-found] [--no-color]
                [--browse] [--local] [--remote]
                USERNAMES [USERNAMES ...]

positional arguments: USERNAMES
                     One or more usernames to check with social networks.
                     Check similar usernames using {%} (replace to '_', '-', '.').

🌈 positional arguments 🌈

  • USERNAMES — one or more usernames to check with social networks. and bestie listen: you can check similar usernames using {%} (it gets replaced with '_', '-', '.'). iconic behaviour honestly. ✨

🎀 OPTIONS 🎀

💜 optional arguments

  • -h, --help — shows this help message and dips. 👋
  • --version — displays version information and dependencies. the receipts, basically.
  • --verbose, -v, -d, --debug — displays extra debugging information and metrics. for when you wanna see everything happening. highkey obsessed.
  • --folderoutput FOLDEROUTPUT, -fo FOLDEROUTPUT — if you're using multiple usernames, the output of the results gets saved to this folder. 🍓
  • --output OUTPUT, -o OUTPUT — if you're using a single username, the output of the result gets saved to this file.
  • --tor, -t — makes requests over Tor; increases runtime; requires Tor to be installed and in system path. 🧚 sneaky mode, but slower.
  • --unique-tor, -u — makes requests over Tor with a new Tor circuit after each request; increases runtime; requires Tor to be installed and in system path. extra sneaky, extra slow, truly a commitment.
  • --csv — creates a Comma-Separated Values (CSV) File. spreadsheet girlies rise. 📊
  • --xlsx — creates the standard file for the modern Microsoft Excel spreadsheet (xslx).
  • --site SITE_NAME — limits analysis to just the listed sites. add multiple options to specify more than one site. pick your faves only. 👑
  • --proxy PROXY_URL, -p PROXY_URL — makes requests over a proxy. e.g. socks5://127.0.0.1:1080
  • --json JSON_FILE, -j JSON_FILE — loads data from a JSON file or an online, valid, JSON file. 🦋
  • --timeout TIMEOUT — time (in seconds) to wait for response to requests (Default: 60)
  • --print-all — outputs sites where the username was not found. the full picture, no filter.
  • --print-found — outputs sites where the username was found. the hits only. 🔥
  • --no-color — doesn't color terminal output. for the monochrome minimalists among us.
  • --browse, -b — browses to all results on default browser. main character move.
  • --local, -l — uses the local data.json file.
  • --remote — fetches data.json from GitHub instead of using the local file. 🌈

⭐ EXAMPLES ⭐

to search for only one user:

a)python3 sherlock user123

to search for more than one user:

b) python3 sherlock user1 user2 user3

🔍 SEE ALSO 🔍

take a look at https://sherlock-project.github.io/ for information on how to use. go read it, bestie, it's short i promise 🫶

💖 AUTHOR 💖

okay that's the whole page, no notes 💅✨ this was SHERLOCK 0.15.0, dated JUL 2024 — thanks for reading bestie, go find some usernames 🎀🦋💖

📦 where this page comes from