{"id":28951492,"url":"https://github.com/eternaldreamer01/nyx","last_synced_at":"2026-03-07T06:31:15.575Z","repository":{"id":290647025,"uuid":"975107786","full_name":"EternalDreamer01/Nyx","owner":"EternalDreamer01","description":"Reverse phone lookup, based on WhatsApp and Telegram","archived":false,"fork":false,"pushed_at":"2025-06-22T15:07:33.000Z","size":447,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-22T15:42:22.930Z","etag":null,"topics":["caller-info","caller-lookup","information-gathering","osint","phone","phone-lookup","phone-verification","reverse-lookup","reverse-phone-lookup","telegram","telegram-api","whatsapp","whatsapp-api","whatsapp-web","who-called"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EternalDreamer01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-29T19:47:22.000Z","updated_at":"2025-06-22T15:07:34.000Z","dependencies_parsed_at":"2025-06-09T14:24:30.648Z","dependency_job_id":"62630fce-d81b-40a8-864a-1d66ad21dba1","html_url":"https://github.com/EternalDreamer01/Nyx","commit_stats":null,"previous_names":["mikecod/venom-cli","mikecod/nyx","eternaldreamer01/nyx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/EternalDreamer01/Nyx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EternalDreamer01%2FNyx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EternalDreamer01%2FNyx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EternalDreamer01%2FNyx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EternalDreamer01%2FNyx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EternalDreamer01","download_url":"https://codeload.github.com/EternalDreamer01/Nyx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EternalDreamer01%2FNyx/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261500286,"owners_count":23168066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["caller-info","caller-lookup","information-gathering","osint","phone","phone-lookup","phone-verification","reverse-lookup","reverse-phone-lookup","telegram","telegram-api","whatsapp","whatsapp-api","whatsapp-web","who-called"],"created_at":"2025-06-23T15:02:19.212Z","updated_at":"2026-03-07T06:31:14.636Z","avatar_url":"https://github.com/EternalDreamer01.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nyx 🌙\n\n## Overview\n\nNyx is a **simple reverse phone lookup** ;\nthat is, a tool to obtain information about the subscriber (owner) of the phone number.\n\nPlease read [Disclaimer](#disclaimer), [Is it legal ?](#is-it-legal-) and [Are there any risk ?](#are-there-any-risk-).\n\n**When the features become the weaknesses...**\n\nNyx aims to highlight the weaknesses of instant‑messaging apps and increase public awareness of them. These common features allow malicious actors to perform reverse phone lookups and harvest personal data associated with a phone number.\nThese data include :\n* Username\n* Photo\n* Bio\n* Last activity\n* and more...\n\n*See [Setup Inspected Applications](#setup-inspected-applications) for more information*\n\n## Table of contents \n\n2. [Disclaimer](#disclaimer)\n2. [Install](#install)\n    * [Setup Inspected Applications](#setup-inspected-applications)\n2. [Usage](#usage)\n2. [FAQ](#faq)\n\t* [Is the user notified about this ?](#is-the-user-notified-about-this-)\n\t* [Is it possible to login as another phone number but personal ?](#is-it-possible-to-login-as-another-phone-number-but-personal-)\n\t* [Are there any risk ?](#are-there-any-risk-)\n\t* [Is it legal ?](#is-it-legal-)\n\t* [What's the difference between \"name\" and \"pushname\" ?](#whats-the-difference-between-name-and-pushname-)\n\n\n## Disclaimer\n\nThis project is intended for educational and lawful purposes only. The primary goal is to provide users with a platform to learn and experiment with various technologies, programming languages, and security concepts in a controlled environment. The creators and contributors of this project do not endorse or support any malicious activities, including but not limited to hacking, unauthorized access, or any form of cybercrime.\n\nUsers are expected to use this project responsibly and in compliance with applicable laws and regulations. Unauthorized use of this project for any malicious or illegal activities is strictly prohibited. The creators and contributors disclaim any responsibility for any misuse or damage caused by the use of this project for unauthorized and unlawful purposes.\n\nIt is essential to respect the privacy and security of others and obtain explicit permission before attempting to access or modify any system or data. Any actions performed with the knowledge gained from this project should be conducted in an ethical manner, with a focus on enhancing cybersecurity/privacy awareness and promoting responsible use of technology.\n\nBy using this project, you acknowledge and agree to abide by the principles outlined in this disclaimer. If you do not agree with these terms, you are not authorized to use or contribute to this project.\n\n## Install\n\n```sh\nnpm i -g nyx-lookup\n```\n\n### Development\n\n```sh\ngit clone --recurse-submodules -j4 https://github.com/EternalDreamer01/Nyx.git\n```\n\n### Prerequisites\n\n* Node 20+\n\n### Setup Inspected Applications\n\n| API | Information | Login | Session location |\n|-|-|-|-|\n| WhatsApp | \u003cul\u003e\u003cli\u003eType (User/Business)\u003c/li\u003e\u003cli\u003e[Name / pushname](#whats-the-difference-between-name-pushname-and-shortname-) \u003c/li\u003e\u003cli\u003ePicture\u003c/li\u003e\u003cli\u003eAbout\u003c/li\u003e\u003cli\u003eLast activity\u003c/li\u003e\u003c/ul\u003e | QR code | \u003ctable\u003e\u003cthead\u003e\u003ctr\u003e\u003cth\u003eOS\u003c/th\u003e\u003cth\u003eDirectory\u003c/th\u003e\u003c/tr\u003e\u003c/thead\u003e\u003ctbody\u003e\u003ctr\u003e\u003ctd\u003eWindows\u003c/td\u003e\u003ctd\u003e`%LocalAppData%`\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eLinux\u003c/td\u003e\u003ctd\u003e`~/.cache`\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003emacOS\u003c/td\u003e\u003ctd\u003e`~/Library/Caches`\u003c/td\u003e\u003c/tr\u003e\u003c/tbody\u003e\u003c/table\u003e |\n| Telegram | \u003cul\u003e\u003cli\u003eType (User/Business)\u003c/li\u003e\u003cli\u003eBot\u003c/li\u003e\u003cli\u003eRestriction\u003c/li\u003e\u003cli\u003eFirst/last name / Username\u003c/li\u003e\u003cli\u003eVerified\u003c/li\u003e\u003cli\u003ePremium\u003c/li\u003e\u003cli\u003ePicture\u003c/li\u003e\u003cli\u003eLanguage\u003c/li\u003e\u003cli\u003eLast activity\u003c/li\u003e\u003c/ul\u003e | [**API Token**](https://my.telegram.org/apps) | Environment. See `nyx-lookup -e` |\n\nYou must login to use their API ;\n* WhatsApp access is via a QR Code\n* Telegram access is via an [API token](https://my.telegram.org/apps). Edit with the command `nyx-lookup -e`:\n\t* `API_TELEGRAM_ID` and `API_TELEGRAM_HASH`\n\t* Login once with the code you receive, it will store the token in `API_TELEGRAM_TOKEN`\n\n\n## Usage\n\n__Supports international phone format only__\n\nRaw format is digits only (e.g `61491570006`) however, you may optionally specify :\n* `+` at the beginning, eventually followed by `0`: `+0448081570192`\n* `-`, `.`, ` ` (space), `/` and `\\` anywhere: `61 491-570-006`\n\n```sh\n$ nyx-lookup \"+44 808 157 0192\"\n$ nyxl 448081570192\n```\n```\n$ nyx-lookup\nUsage: nyx-lookup [options] phone\n\n  -p --photo        Download photo into '/home/\u003cuser\u003e/nyx-lookup'\n  -s --[no-]save    Save user info and photo (autosave: yes)\n  -f --format={ text | json }\n                    Define output format (default: text)\n  -c --[no-]colour  No colour (only for 'text' format) (default: yes)\n  -e --env          Edit env file (default editor: vim)\n     --api={ wa | tg | all }\n                    API service to use (default: all)\n     --force        Force query, do not use cached data.\n     --db           Access database cache.\n     --open-photos[=phone]\n                    Access cached photos.\n\n     --non-interactive\n                    Will not ask to login if no session was found\n     --test         Test phone from env. variable PHONE_TEST\n                    Non-interactive is automatically true\n                    \n  -h --help        Show this help\n  -v --version     Show version\n  \n  Status:\n    WhatsApp: ✔\n    Telegram: ✔\n```\n\n### Variables\n\nEditable using `nyx-lookup -e` ;\n\n| Variable | Description | Default | Possible values |\n|-|-|-|-|\n| `API_TELEGRAM_ID` | Telegram ID (required to use Telegram API) | *None* | |\n| `API_TELEGRAM_HASH` | Telegram Hash (required to use Telegram API) | *None* | |\n| `DEFAULT_INFO_FORMAT` | Default output format | `text` | `text` or `json` |\n| `AUTOSAVE` | Enable/disable autosave (`~/nyx-lookup/saved.db`) | `true` | `true`/`false`, `yes`/`no`, `1`/`0` |\n| `PHONE_TEST` | Phone number to use for testing | *None* | |\n\nThe database of saved results is accessible at `~/nyx-lookup/saved.db`.\nTo enable/disable autosave, run `nyx-lookup -e` and edit `AUTOSAVE`.\n\n## FAQ\n\n### Is the user notified about this ?\nNo\n\n### Is it possible to login as another phone number but personal ?\nYes - it'd be advised to prevent ban - it's a common thing to buy a prepaid SIM card from tobacconists or local stores.\n\n### Can a user actually have WhatsApp or Telegram but doesn't appear ?\nYes, users can always change their profile visibility. To view or edit these settings :\n* WhatsApp : Settings \u003e Privacy\n* Telegram : Settings \u003e Privacy and Security\n\n### Are there any risk ?\nThe possible potential risks, temporary or permanently :\n1. Restricted to use WhatsApp through another device, or Telegram API\n2. Account suspension via phone number\n\nA reasonable reverse lookup frequency would be ;\n| WhatsApp | Telegram |\n|-|-|\n| 4/day | 12/day |\n\nWaiting at least a few seconds between each call, at an irregular frequency.\nUse a prepaid SIM card to prevent such situations.\n\n### Is it legal ?\nIt's legal to view publicly or freely available information, when the user is aware of this feature and consented to it.\nHowever, scraping would be considered a privacy violation in many jurisdiction (including EU and US), and would violate Terms of Use of WhatsApp and Telegram.\n\nDoing so could result in a permanent suspension, and a criminal penalty.\n\nMoreover, the constant storage of this data could be considered a privacy violation (mainly for EU). You might consider editing `AUTOSAVE` and manage your cache yourself.\nYou alone bear full responsibility for any misuse or damage resulting from the unauthorized or unlawful use of this project.\n\n### What's the difference between \"name\" and \"pushname\" ?\n|||\n|-|-|\n| `name` | The name registered for this phone number on your personal WhatsApp account |\n| `pushname` | The name configured on their WhatsApp |\n\n## Frequent Issues\n\n### Cache\nIf you were getting this error:\n```\nError: Evaluation failed: Error: wid error: invalid wid\n```\nTry cleaning up cache using `nyx-lookup --clean` or `rm -rf ~/.cache/nyx-lookup/`\n\n### Outdated Version\nIf you were getting this error:\n```\nError: Evaluation failed: TypeError: Cannot read properties of undefined (reading 'default')\n```\nMake sure you have the latest version of Nyx, or try reinstalling. If you installed it globally using npm:\n```sh\nnpm uninstall -g nyx-lookup\nnpm install -g nyx-lookup\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first\nto discuss what you would like to change.\n\n## License\n\n[LGPL-3.0 or later](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feternaldreamer01%2Fnyx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feternaldreamer01%2Fnyx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feternaldreamer01%2Fnyx/lists"}