Skip to main content

Unified OSINT CLI — aggregates Sherlock, Holehe, Maigret, GHunt and PhoneInfoga into a single command.

Project description

omniscan

One command. Every OSINT tool.

omniscan is a unified OSINT CLI that aggregates the best open-source intelligence tools into a single interface — no more switching between terminals, remembering different flags, or managing separate installs. Feed it a username, email, or phone number and it fans out across all the right tools automatically.

Tool What it covers Flag
Built-in checks GitHub, GitLab, Instagram, Reddit, Twitter, Firefox (always on)
Sherlock 480+ sites — username sweep --sherlock
Holehe 120+ sites — email registration check --holehe
Maigret 2500+ sites — deep username profiling --maigret
GHunt Google account OSINT from email --ghunt
PhoneInfoga Phone number intelligence --phoneinfoga

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.

Credits

omniscan is built on top of socialscan by iojw, which provides the core platform-checking engine and the registration-API approach that makes the built-in checks accurate. The aggregation layer, additional tool integrations, and binary distribution are omniscan's additions — but the foundation is theirs.

The bundled tools each have their own authors and communities:

License

MPL 2.0 — inherited from socialscan.

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.6.tar.gz (24.2 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.6-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: omniscan-2.0.6.tar.gz
  • Upload date:
  • Size: 24.2 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.6.tar.gz
Algorithm Hash digest
SHA256 be01311dd34a055f938d39791b43558625a4d71bd5cdee6b8890f361d5e2fd5f
MD5 5de7600cc994bf86b32634c11320939b
BLAKE2b-256 5694fbdf50625e94c4e6acc47535b2309624ceadb8f2aba331d371f40124116b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: omniscan-2.0.6-py3-none-any.whl
  • Upload date:
  • Size: 23.2 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 897b43356ed5be22ffbca299d6a7b3e137d88c1d05393ea1b8605bd296be0612
MD5 cde659881734aba0298d39c099ac5eb3
BLAKE2b-256 318cb156cb5fa7ca292568792db22f83b912612ad629ab9cb773b07cce0d379b

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