Metadata-Version: 2.4
Name: omniscan
Version: 2.0.6
Summary: Unified OSINT CLI — aggregates Sherlock, Holehe, Maigret, GHunt and PhoneInfoga into a single command.
Home-page: https://github.com/HubDamian95/omniscan
Author: HubDamian95
Keywords: email email-checker username username-checker social-media osint sherlock
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dataclasses; python_version < "3.7"
Requires-Dist: colorama
Requires-Dist: aiohttp>=3.5.0
Requires-Dist: tqdm>=4.31.0
Requires-Dist: sherlock-project>=0.15.0
Requires-Dist: holehe>=1.8.0
Requires-Dist: httpx>=0.24.0
Provides-Extra: tests
Requires-Dist: dataclasses; python_version < "3.7" and extra == "tests"
Requires-Dist: colorama; extra == "tests"
Requires-Dist: aiohttp>=3.5.0; extra == "tests"
Requires-Dist: tqdm>=4.31.0; extra == "tests"
Requires-Dist: sherlock-project>=0.15.0; extra == "tests"
Requires-Dist: holehe>=1.8.0; extra == "tests"
Requires-Dist: httpx>=0.24.0; extra == "tests"
Requires-Dist: tox; extra == "tests"
Requires-Dist: flake8; extra == "tests"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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](https://github.com/sherlock-project/sherlock) | 480+ sites — username sweep | `--sherlock` |
| [Holehe](https://github.com/megadose/holehe) | 120+ sites — email registration check | `--holehe` |
| [Maigret](https://github.com/soxoj/maigret) | 2500+ sites — deep username profiling | `--maigret` |
| [GHunt](https://github.com/mxrch/GHunt) | Google account OSINT from email | `--ghunt` |
| [PhoneInfoga](https://github.com/sundowndev/phoneinfoga) | Phone number intelligence | `--phoneinfoga` |

## Install

```bash
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:
> ```bash
> 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:
```bash
omniscan johndoe
```

Check a username with full Sherlock sweep:
```bash
omniscan johndoe --sherlock --show-urls
```

Check email availability:
```bash
omniscan johndoe@gmail.com johndoe@outlook.com
```

Scan a phone number:
```bash
omniscan +12025551234 --phoneinfoga
```

Check email on 120+ sites via Holehe:
```bash
omniscan johndoe@gmail.com --holehe
```

Sweep username across 2500+ sites via Maigret:
```bash
omniscan johndoe --maigret
```

Google account OSINT (requires `ghunt login` once):
```bash
omniscan johndoe@gmail.com --ghunt
```

Everything at once:
```bash
omniscan johndoe johndoe@gmail.com +12025551234 --sherlock --holehe --maigret --ghunt --phoneinfoga --show-urls
```

Check only specific platforms:
```bash
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](https://github.com/iojw/socialscan) by [iojw](https://github.com/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:
- [Sherlock](https://github.com/sherlock-project/sherlock) — sherlock-project
- [Holehe](https://github.com/megadose/holehe) — megadose
- [Maigret](https://github.com/soxoj/maigret) — soxoj
- [GHunt](https://github.com/mxrch/GHunt) — mxrch
- [PhoneInfoga](https://github.com/sundowndev/phoneinfoga) — sundowndev

## License

[MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/) — inherited from socialscan.
