Skip to main content

Username and email availability scanner with full-spectrum coverage. Combines accurate registration-API checks with Sherlock's 480+ site sweep.

Project description

omniscan

Username, email and phone number scanner. Combines accurate registration-API checks on key platforms with Sherlock's 480+ site sweep and PhoneInfoga phone number intelligence — all in a single command.

Forked from socialscan.

Install

curl -fsSL https://raw.githubusercontent.com/HubDamian95/omniscan/master/install.sh | bash

This installs:

  • omniscan — pre-built binary (includes Sherlock + Holehe bundled)
  • PhoneInfoga — Go binary for phone number scanning
  • Maigret — 2500+ site username sweep (via pipx, if available)
  • GHunt — Google account OSINT from email (via pipx, if available)

Requirements: curl, tar. That's it — self-contained binaries, no Python or pip needed.

npm alternative — if you prefer Node.js over Python:

npm install -g omniscan

The npm package downloads the pre-built omniscan binary for your OS. Note: this path does not include PhoneInfoga — run the curl installer above to add phone scanning on top.

Usage

omniscan [usernames/email addresses/phone numbers]

options:
  -h, --help                        show this help message and exit
  --platforms [-p] platform [...]   list of platforms to query (default: all)
  --view-by {platform,query}        sort results by platform or query
  --available-only, -a              only show available usernames/emails
  --cache-tokens, -c                cache tokens to reduce total requests
  --input, -i input.txt             file containing list of queries
  --proxy-list proxy_list.txt       file containing HTTP proxy servers
  --verbose, -v                     show responses as they arrive
  --show-urls                       display profile URLs for found usernames
  --sherlock, -s                    also run Sherlock across 480+ sites
  --holehe                          check email on 120+ sites via Holehe (bundled)
  --maigret                         sweep username across 2500+ sites via Maigret
  --ghunt                           Google account OSINT from email via GHunt (requires ghunt login)
  --phoneinfoga, -n                 scan phone numbers via PhoneInfoga
  --json json.txt                   output results as JSON
  --debug                           output debug messages
  --version                         show version

Examples

Check a username:

omniscan johndoe

Check a username with full Sherlock sweep:

omniscan johndoe --sherlock --show-urls

Check email availability:

omniscan johndoe@gmail.com johndoe@outlook.com

Scan a phone number:

omniscan +12025551234 --phoneinfoga

Check email on 120+ sites via Holehe:

omniscan johndoe@gmail.com --holehe

Sweep username across 2500+ sites via Maigret:

omniscan johndoe --maigret

Google account OSINT (requires ghunt login once):

omniscan johndoe@gmail.com --ghunt

Everything at once:

omniscan johndoe johndoe@gmail.com +12025551234 --sherlock --holehe --maigret --ghunt --phoneinfoga --show-urls

Check only specific platforms:

omniscan johndoe --platforms github reddit gitlab

Supported platforms

Username Email
GitHub
GitLab
Instagram
Reddit
Twitter
Firefox

Plus 480+ sites via --sherlock and phone number intelligence via --phoneinfoga.

License

MPL 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

omniscan-2.0.5.tar.gz (23.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

omniscan-2.0.5-py3-none-any.whl (22.7 kB view details)

Uploaded Python 3

File details

Details for the file omniscan-2.0.5.tar.gz.

File metadata

  • Download URL: omniscan-2.0.5.tar.gz
  • Upload date:
  • Size: 23.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for omniscan-2.0.5.tar.gz
Algorithm Hash digest
SHA256 f1aecec051d41e809060082c9be7e56aef92c275fb5a95fc77e6931e1b7c940d
MD5 7e26c710c3cea8c0f43357c963709822
BLAKE2b-256 5da1ae8c97e05d19d864a74c30c186f44e214f0dc1e1e7a8617fbe9178072d03

See more details on using hashes here.

File details

Details for the file omniscan-2.0.5-py3-none-any.whl.

File metadata

  • Download URL: omniscan-2.0.5-py3-none-any.whl
  • Upload date:
  • Size: 22.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for omniscan-2.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 615ce82f2bc381abb755e1db34d17a428e74500f7d5e75669373c31b0bcd27c5
MD5 0c34716daac6ecffd0842c2ad85cf4c0
BLAKE2b-256 b44dd0644c39717465eb7ae94630a812e5917111989b6f9bfb514db0e08a0327

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page