{"id":23357280,"url":"https://github.com/bhattjayd/passbreachfinder","last_synced_at":"2026-05-02T02:39:25.437Z","repository":{"id":266322834,"uuid":"897987170","full_name":"BhattJayD/PassBreachFinder","owner":"BhattJayD","description":"A Python script that checks whether a password has been compromised using the Have I Been Pwned service. The script automates the process of querying the website and retrieving the results for the given password, leveraging Selenium and a headless Firefox browser. It’s a simple tool for testing password security and checking for data breaches.","archived":false,"fork":false,"pushed_at":"2024-12-03T17:12:14.000Z","size":2087,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T20:13:05.913Z","etag":null,"topics":["automation","command-line-tool","cybersecurity","data-breach","data-breach-checker","geckodriver","haveibeenpwned","headless-browser","password-leak","password-security","python","security-tool","selenium","web-scraping","web-scraping-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BhattJayD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-12-03T15:33:48.000Z","updated_at":"2025-01-03T01:34:59.000Z","dependencies_parsed_at":"2024-12-03T18:19:03.646Z","dependency_job_id":"f8a591e4-44be-4981-835b-a33fbf6156da","html_url":"https://github.com/BhattJayD/PassBreachFinder","commit_stats":null,"previous_names":["bhattjayd/passbreachfinder"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhattJayD%2FPassBreachFinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhattJayD%2FPassBreachFinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhattJayD%2FPassBreachFinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BhattJayD%2FPassBreachFinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BhattJayD","download_url":"https://codeload.github.com/BhattJayD/PassBreachFinder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247721921,"owners_count":20985084,"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":["automation","command-line-tool","cybersecurity","data-breach","data-breach-checker","geckodriver","haveibeenpwned","headless-browser","password-leak","password-security","python","security-tool","selenium","web-scraping","web-scraping-python"],"created_at":"2024-12-21T10:19:57.859Z","updated_at":"2026-05-02T02:39:25.372Z","avatar_url":"https://github.com/BhattJayD.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PassBreachFinder\n\nPassBreachFinder is a simple Python script that checks if a password has been compromised using the [Have I Been Pwned](https://haveibeenpwned.com/) service. The script automates the process of querying the website by using Selenium and retrieving the results for the given password.\n\n## Features\n\n- **Check if a password has been compromised**: Pass a password via the command line, and the script will tell you if it's been part of any known data breaches.\n- **Headless Browser**: Uses a headless Firefox browser for automated web scraping without requiring a GUI.\n\n## Prerequisites\n\nTo use this script, you’ll need the following:\n\n- Python 3.x\n- Selenium\n- Geckodriver (for Firefox)\n- Firefox Web Browser\n\n### Install Required Packages\n\nYou can install the necessary Python libraries by running:\n\n```bash\npip install -r requirements.txt\n```\n\nAdditionally, make sure that [Geckodriver](https://github.com/mozilla/geckodriver/releases) is installed on your system and accessible via the `PATH`.\n\n### Download Geckodriver (for Firefox):\n\n1. Download the [Geckodriver](https://github.com/mozilla/geckodriver/releases) that matches your system’s architecture.\n2. Extract it and add the path to the Geckodriver executable in your system's environment variables or specify the path directly in the script.\n\n## Usage\n\n1. Clone or download the script.\n2. Open a terminal window in the directory where the script is located.\n3. Run the script by providing a password using the `-p` option:\n\n```bash\npython app.py -p \"your_password_here\"\n```\n\n### Example:\n\n```bash\npython app.py -p \"password123\"\n```\n\nIf the password has been compromised, you will see a message like:\n\n```\npassword123 This password has been pwned 5 times.\n```\n\nIf the password is safe, you will see:\n\n```\nsafe\n```\n\n## How It Works\n\n1. **Command-Line Argument**: The script accepts a password as an argument via the command line (`-p`).\n2. **Headless Browser**: It uses Selenium with a headless Firefox browser to interact with the [Have I Been Pwned Passwords page](https://haveibeenpwned.com/Passwords).\n3. **Password Checking**: It enters the provided password into the search form on the page and submits it. After waiting for the results, it checks if the password has been pwned.\n4. **Results**: The script will display whether the password is safe or has been exposed in a data breach.\n\n## Troubleshooting\n\n- **Geckodriver Not Found**: If you're getting an error regarding `Geckodriver`, ensure it’s installed and properly referenced in the script or the environment variables.\n- **Headless Mode**: If you'd like to see the browser in action (not headless), remove or comment out the line `options.add_argument(\"--headless\")`.\n\n## License\n\nThis script is licensed under the MIT License. See `LICENSE` for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhattjayd%2Fpassbreachfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbhattjayd%2Fpassbreachfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhattjayd%2Fpassbreachfinder/lists"}