Skip to main content

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.

Metadata

Release files for omniscan 2.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for omniscan 2.0.6
File Size Uploaded Provenance Actions
omniscan-2.0.6.tar.gz 24.2 kB Without provenance Details for omniscan-2.0.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for omniscan 2.0.6
File Interpreter ABI Platform Actions
omniscan-2.0.6-py3-none-any.whl Python 3 none any Details for omniscan-2.0.6-py3-none-any.whl

Total release size: 47.4 kB

Release files / omniscan-2.0.6.tar.gz

Download URL omniscan-2.0.6.tar.gz
Size 24.2 kB
Tags Source
SHA-256 checksum
How to use checksums
be01311dd34a055f938d39791b43558625a4d71bd5cdee6b8890f361d5e2fd5f
BLAKE2b-256 checksum
How to use checksums
5694fbdf50625e94c4e6acc47535b2309624ceadb8f2aba331d371f40124116b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release files / omniscan-2.0.6-py3-none-any.whl

Download URL omniscan-2.0.6-py3-none-any.whl
Size 23.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
897b43356ed5be22ffbca299d6a7b3e137d88c1d05393ea1b8605bd296be0612
BLAKE2b-256 checksum
How to use checksums
318cb156cb5fa7ca292568792db22f83b912612ad629ab9cb773b07cce0d379b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Security for omniscan 2.0.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.0.6 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page