gophoner​​     

Check simultaneously if a phone number is registered on popular apps & websites, without any prerequisite.

Please star & share this repository if you find it useful ⭐

Table of Contents

• Disclaimer
• Features
• Installation
• Usage
• Supported Modules
• Roadmap
• Legal & Ethical Use
• License
• Credits

Disclaimer ⚠️

[!CAUTION] It is important you read the full policy of this project before using or contributing to this tool.

Please refer to the following sections:

• Legal & Ethical Use
• License

I am not responsible for your usage of this tool.

Features

• CLI and TUI: use gophoner check for scripting and automation, or gophoner interactive for a guided terminal interface.
• Cross-platform: prebuilt binaries for Windows, Linux, and macOS.
• Concurrent module checks: every selected module runs in parallel, so checking a phone number against several services takes about as long as the slowest one, not the sum of them all.
• Silent by default: none of the currently supported modules alert or notify the target phone number, no SMS or email triggered while checking. If a future module does trigger a notification on the target's end, it will be called out explicitly.
• Privacy conscious logging: target phone numbers are never written to the log file unless --debug is set, and --no-log disables all logging entirely.
• Randomized browser fingerprinting: each request gets an internally consistent TLS, User-Agent, and Client Hints profile drawn from a real desktop browser pool, making requests far harder to fingerprint and block than a plain HTTP client.
• Single target scope: checks one phone number against your chosen modules per invocation, not built for bulk enumeration.
• Update aware: checks for new releases on startup and lets you know when one is available, disable with --no-update.
• JSON output: --json formats the results as a single JSON object on stdout, for piping into other scripts & tools.

Installation 💻

Requires Go 1.26 or newer.

go install github.com/M4elstr0m/gophoner/cmd/gophoner@latest

[!IMPORTANT] This only works on Arch-based Linux distributions.

Requires paru or yay installed.

# WORK IN PROGRESS (THIS IS PLANNED)

[!IMPORTANT] This only works on Windows.

Requires winget installed.

winget install M4elstr0m.gophoner

[!IMPORTANT] This only works on macOS.

Requires brew installed.

brew install --cask M4elstr0m/tap/gophoner

Check if the installation succeeded

gophoner version

Usage 📚

gophoner help

gophoner interactive

gophoner check -t +15551234567 -A

Modules 🧩

v1.0.0 Modules

Roadmap 🗺️

• v1.0.0
  • Initial tool and Amazon module
  • More modules: Microsoft, Facebook, Amazon & plenty more surprises 😶
  • CLI QoL: progress bar
  • gophoner logo & a see it in action GIF
  • More release platforms (Go Install, Winget, Homebrew)
  • Format output in JSON
• Add AUR to release platforms
• CLI QoL: only display positive results, progressive results display, fun facts during progress
• More modules!
• A plug-in system (maybe)

Legal & Ethical Use 📜

gophoner is built for security research, personal OSINT hygiene (checking your own digital footprint), and educational purposes.

Checking a phone number against a service without the number holder's consent may violate that service's Terms of Service, and, depending on your jurisdiction and how you use the results, local privacy, stalking, or harassment laws. You are solely responsible for ensuring your use of this tool is lawful and authorized.

Do not use gophoner to harass, stalk, dox, or otherwise target an individual without their consent. The author provides this software as is, disclaims all liability for its use or misuse, and does not endorse or support any unlawful use of it.

gophoner is designed with the operator's own privacy in mind: by default it never writes target phone numbers to its log file (only at --debug level), and a --no-log is also at your disposal to disable all logging entirely.

gophoner is also architecturally scoped to reduce abuse potential: it checks a single phone number against your chosen modules per invocation. It is not built for bulk enumeration or sweeping ranges of numbers, even though a basic script wrapping the CLI could still automate that.

License ⚖️

Licensed under PolyForm Internal Use License 1.0.0.

Here is a plain-language summary, which is not a substitute for the license itself:

🟩 You can:

• Use gophoner, including for your company's internal business operations, commercial use included.
• Modify the code for your own private/internal use.
• Fork it to prepare and submit a pull request back to this repository.
• Read the full source code.

🟥 You can't:

• Distribute or redistribute gophoner, or any modified version of it, to anyone else.
• Offer it as a hosted or managed service to third parties.
• Sublicense or transfer your rights to someone else.
• Expect a warranty: it's provided "as is", with no liability to the author.

If gophoner is useful to you, a star, or a mention to your colleagues, is always appreciated 😉

Credits 📰

• The guy who tried to log into one of my accounts at 3 AM, 20 times in 30 minutes, then gave up. He gave me the insomnia that built this tool.
• sherlock & holehe, tools that also use a single credential to check hundreds of services
• ignorant, the first tool I found when searching for something that already did what I had in mind

Go back to top ⬆️