{"id":14978771,"url":"https://github.com/jasperan/whatsapp-osint","last_synced_at":"2025-05-16T10:06:07.238Z","repository":{"id":43669034,"uuid":"221728781","full_name":"jasperan/whatsapp-osint","owner":"jasperan","description":"WhatsApp spy - logs online/offline events from ANYONE in the world","archived":false,"fork":false,"pushed_at":"2024-04-03T21:35:00.000Z","size":15908,"stargazers_count":973,"open_issues_count":2,"forks_count":123,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-04-09T04:06:37.157Z","etag":null,"topics":["bot","logger","osint","python","selenium","spy","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jasperan.png","metadata":{"files":{"readme":"README.md","changelog":"History_wp.xlsx","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}},"created_at":"2019-11-14T15:27:01.000Z","updated_at":"2025-04-07T15:28:24.000Z","dependencies_parsed_at":"2024-04-03T00:30:13.887Z","dependency_job_id":"a7a4651e-7867-4dc8-815e-9f752f5dcee8","html_url":"https://github.com/jasperan/whatsapp-osint","commit_stats":{"total_commits":55,"total_committers":12,"mean_commits":4.583333333333333,"dds":0.5454545454545454,"last_synced_commit":"d630199323e91b4fe0fa4934089ee0e007832f05"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasperan%2Fwhatsapp-osint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasperan%2Fwhatsapp-osint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasperan%2Fwhatsapp-osint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasperan%2Fwhatsapp-osint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jasperan","download_url":"https://codeload.github.com/jasperan/whatsapp-osint/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254509477,"owners_count":22082891,"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":["bot","logger","osint","python","selenium","spy","whatsapp"],"created_at":"2024-09-24T13:58:21.665Z","updated_at":"2025-05-16T10:06:07.232Z","avatar_url":"https://github.com/jasperan.png","language":"Python","funding_links":[],"categories":["bot"],"sub_categories":[],"readme":"# 🕵️‍♂️ WhatsApp OSINT Tool\n\n## 🌟 Example\n\n![example](./img/doc1.PNG?raw=true)\n\nWelcome to the first WhatsApp OSINT tool. This was developed in early 2019 but I decided to restart the project now for fun. \n\n---\n\n# 🌍 English\n\n## 🛠️ How to Install\n\nFirst, install requirements:\n\n```bash\npip install -r requirements.txt\n```\n\n- ✅ You will need **chromedriver**, or you can modify the code and use GeckoDriver or any other drivers for Selenium.\n- ✅ You will need a **GUI** to execute the code since it interacts with web.whatsapp.com to get statuses.\n- ✅ Replace the name in the file with whichever name you want to track.\n\n---\n\n## 🚀 How to Run\n\nThe language you choose depends on the **language** in which you have your WhatsApp Web. Some of the languages already integrated are the following:\n\n| 🌐 Language | Code |\n|-------------|------|\n| 🇪🇸 Spanish  | es   |\n| 🇬🇧 English  | en   |\n| 🇫🇷 French   | fr   |\n| 🇹🇷 Turkish  | tr   |\n\nIn the user section, you must put the user you want to monitor through the program. The execution as such would be as follows:\n\n```bash\npython3 whatsappbeacon.py --username \u003cusername_to_track\u003e --language \"\u003clanguage_code\u003e\"\n```\n\n---\n\n## 📊 Export Data to Excel\n\nTo obtain the data generated by means of Excel, you can execute the following command with the **flag** `-e`:\n\n```bash\npython3 whatsappbeacon.py --username \u003cusername_to_track\u003e --language \"\u003clanguage_code\u003e\" -e\n```\n\n#### Example\n![img_2.png](img/img_2.png)\n\nWhere `language_code` is either `en`, `tr`, or `es` for English, Turkish, and Spanish languages. Future language support will be added.\n\n---\n\n## 🙌 Credits\n\nThis tool was developed by myself in my free time. It's a tool that demonstrates the power of Selenium and web scraping. I don't endorse using this tool for stalking people or any other fraudulent purposes.\n\nSpecial thanks to:\n- [jasperan](https://github.com/jasperan)\n\n---\n\n# 🇪🇸 Español\n\nBienvenido a la primera herramienta OSINT de WhatsApp. Esto se desarrolló a principios de 2019, pero decidí retomar el proyecto ahora por diversión.\n\n---\n\n## 🛠️ Como instalar\n\n```bash\npip install -r requirements.txt\n```\n\n- ✅ Necesitas **chromedriver**, o puedes modificar el código y usar GeckoDriver o cualquier otro controlador para Selenium.\n- ✅ Necesitarás una **GUI** para ejecutar el código, ya que interactúa con web.whatsapp.com para obtener estados.\n- ✅ Reemplaza el nombre en el archivo con el nombre que desees rastrear.\n\n---\n\n## 🚀 Como ejecutar\n\nEl lenguaje que escoja depende del **idioma** en el que usted tenga su WhatsApp Web. Algunos de los idiomas ya integrados son los siguientes:\n\n| 🌐 Idioma  | Abreviatura |\n|------------|-------------|\n| 🇪🇸 Español | es          |\n| 🇬🇧 Inglés  | en          |\n| 🇫🇷 Francés | fr          |\n| 🇹🇷 Turco   | tr          |\n\nEn el apartado de usuario deberá poner el usuario que desea hacer el seguimiento por medio del programa, así que la ejecución como tal quedaría de la siguiente manera:\n\n```bash\npython3 whatsappbeacon.py --username \u003cusuario\u003e --language \"\u003clenguaje_abreviatura\u003e\"\n```\n\n---\n\n## 📊 Obtener datos de Excel\n\nPara obtener los datos generados por medio de Excel, puede ejecutar el siguiente comando con la **flag** `-e`:\n\n```bash\npython3 whatsappbeacon.py --username \u003cusuario\u003e --language \"\u003clenguaje_abreviatura\u003e\" -e\n```\n\n---\n\n## 🎥 TikTok Tutorial (Spanish)\n\nhttps://user-images.githubusercontent.com/20752424/222984331-4928e06d-7da1-4521-8f2a-37cbb2a4f0cc.mp4\n\nVideo credits go to [linkfydev](https://www.instagram.com/linkfydev/) (thanks for the awesome explanation).\n\n---\n\n## 🙌 Créditos\n\nEsta herramienta fue desarrollada por mí mismo en mi tiempo libre. Es una herramienta que demuestra el poder de Selenium y web scraping. No apruebo el uso de esta herramienta para acechar a las personas o para cualquier propósito fraudulento.\n\n---\n\n## 🌐 Traducción\n\nLa traducción al español fue generada por [daliondev](https://github.com/daliondev).\n\n---\n\n# 🇹🇷 Türkçe \n\nİlk WhatsApp OSINT (Casusluk) aracına hoş geldiniz. Bu araç 2019 senesinde geliştirilmeye başlandı ancak şimdi zevkine tekrardan geliştirmeye karar verdim. \n\n---\n\n## 🛠️ Nasıl İndirebilirim\n\nİlk olarak repoyu indirmemiz gerekiyor ve terminale bu satırı yapıştırıyoruz:\n\n```bash\ngit clone https://github.com/jasperan/whatsapp-osint.git\n```\n\nSonra `requirements.txt` dosyasını indirmemiz gerekiyor. Terminale aşağıdaki kod satırını yapıştırınız:\n\n```bash\npip install -r requirements.txt\n```\n\n- ✅ Chrome Driver'a ihtiyacımız olacaktır. Repoda Chrome Driver mevcuttur. Eğer repo güncel değilse kendiniz indiriniz.\n- ✅ WhatsApp OSINT aracı şuanlık sadece Google Chrome desteklemektedir. Chrome yüklü değilse hata alırsınız. Kendi driverinizi oluşturarak \"Brave, Edge, Safari\" vb. çalıştırabilirsiniz.\n- ✅ Google açıldıktan sonra WhatsApp Web'e tek seferlik giriş yapmanız gerekmektedir. QR kodu okutarak giriş yapınız.\n- ✅ Dosyadaki adı, izlemek istediğiniz adla değiştirin.\n\n---\n\n## 🚀 Programı Nasıl Çalıştırırım\n\nSeçtiğiniz dil, WhatsApp Web'inizin bulunduğu **dile** bağlıdır. Halihazırda entegre edilmiş bazı diller şunlardır:\n\n| 🌐 Dil      | Kod  |\n|-------------|------|\n| 🇪🇸 İspanyol | es   |\n| 🇬🇧 İngilizce | en   |\n| 🇫🇷 Fransızca | fr   |\n| 🇹🇷 Türkçe   | tr   |\n\nKullanıcı bölümünde, program aracılığıyla izlemek istediğiniz kullanıcıyı girmelisiniz. Yürütme aşağıdaki gibi olacaktır:\n\n```bash\npython3 whatsappbeacon.py --username \u003cBu kısma rehberinizdeki kullanıcı adını yazınız\u003e --language \"tr\"\n```\n\n---\n\n## 📊 Excel'den Veri Almak\n\nExcel aracılığıyla oluşturulan verileri elde etmek için **flag** `-e` ile aşağıdaki komutu çalıştırabilirsiniz:\n\n```bash\npython3 whatsappbeacon.py --username \u003cBu kısma rehberinizdeki kullanıcı adını yazınız\u003e --language \"tr\" -e\n```\n\n---\n\n## 🙌 Katkıda Bulunanlar\n\nBu araç benim tarafımdan boş zaman aktivitesi olarak geliştirildi. Aracın insanları \"stalklamanız\" ve \"dolandırmanız\" için kullanmamanızı rica ediyorum çünkü ben bu aracı yalnızca **Selenium** ve **web scraping** gücünü göstermek amacıyla geliştirdim.\n\n---\n\n## 🌐 Tercüme\n\nTürkçe çeviri [BerkeGokturk71](https://github.com/BerkeGokturk71) tarafından yapılmıştır.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasperan%2Fwhatsapp-osint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasperan%2Fwhatsapp-osint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasperan%2Fwhatsapp-osint/lists"}