{"id":21140455,"url":"https://github.com/chickendrop89/oneshot-extended","last_synced_at":"2025-07-09T04:31:28.503Z","repository":{"id":252426427,"uuid":"839898493","full_name":"chickendrop89/OneShot-Extended","owner":"chickendrop89","description":"OneShot-Extended (WPS penetration testing utility) is a fork of the tool with extra android features","archived":false,"fork":false,"pushed_at":"2024-11-09T22:06:41.000Z","size":82,"stargazers_count":5,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-09T23:17:03.746Z","etag":null,"topics":["android","attack","bruteforce","penetration-testing","pixiedust","pixiewps","termux","wireless","wps"],"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/chickendrop89.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-08-08T14:46:29.000Z","updated_at":"2024-11-09T22:06:44.000Z","dependencies_parsed_at":"2024-08-09T18:23:52.150Z","dependency_job_id":"cd3f1e31-3b8b-49f0-8436-5c658ad681d4","html_url":"https://github.com/chickendrop89/OneShot-Extended","commit_stats":null,"previous_names":["chickendrop89/oneshot-extended"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickendrop89%2FOneShot-Extended","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickendrop89%2FOneShot-Extended/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickendrop89%2FOneShot-Extended/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chickendrop89%2FOneShot-Extended/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chickendrop89","download_url":"https://codeload.github.com/chickendrop89/OneShot-Extended/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225482738,"owners_count":17481237,"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":["android","attack","bruteforce","penetration-testing","pixiedust","pixiewps","termux","wireless","wps"],"created_at":"2024-11-20T07:16:04.799Z","updated_at":"2025-07-09T04:31:28.496Z","avatar_url":"https://github.com/chickendrop89.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Overview\n**OneShot-Extended** performs the [Pixie Dust attack](https://forums.kali.org/showthread.php?24286-WPS-Pixie-Dust-Attack-Offline-WPS-Attack) without the requirement of monitor mode.\n\nThis is an improved version of the original OneShot\n\n## Advantages over original OneShot\n - Highlighting of a vulnerable WPS version (1.0) in the scanner\n - Ability to save the AP right into the Network Manager of your system\n - Ability to do a WPS Null/blank pin attack\n - Ability to clear the screen every scan\n - Minor changes (e.g, WPA3TM indication, better vulnwsc detection, RF-Kill handling)\n - Works on modern python versions (\u003e3.9)\n - Improved Android support\n\n# Features\n - [Pixie Dust attack](https://forums.kali.org/showthread.php?24286-WPS-Pixie-Dust-Attack-Offline-WPS-Attack)\n - Offline WPS PIN generating algorithm\n - [Online WPS bruteforce](https://sviehb.files.wordpress.com/2011/12/viehboeck_wps.pdf)\n - Wi-Fi scanner with highlighting based on iw;\n - Ability to write to a file\n\n# Usage\n```\nRequired arguments: \n  -i, --interface INTERFACE    : Name of the interface to use\n\nOptional arguments:\n  -b, --bssid BSSID            : BSSID of the target AP\n  -p, --pin PIN                : Use the specified pin (arbitrary string or 4/8 digit pin). Enter a blank pin (e.g. '') for a Null Pin attack\n  -K, --pixie-dust             : Run Pixie Dust attack\n  -F, --pixie-force            : Run Pixiewps with --force option (bruteforce full range)\n  -B, --bruteforce             : Run online bruteforce attack\n  --pbc, --push-button-connect : Run WPS push button connection\n\nAdvanced arguments:\n  -d, --delay \u003cn\u003e              : Set the delay between pin attempts\n  --vuln-list VULN_LIST        : Use custom file with vulnerable devices list\n\n  -X, --show-pixie-cmd         : Always print Pixiewps command\n  -w, --write                  : Write credentials to the file on success\n  -s, --save                   : Save the AP to network manager on success\n  -l, --loop                   : Run in a loop\n  -c, --clear                  : Clear the screen on every wi-fi scan\n  -r, --reverse-scan           : Reverse order of networks in the list of networks. Useful on small displays\n  --mtk-wifi                   : Activate MediaTek Wi-Fi interface driver on startup and deactivate it on exit (for internal Wi-Fi adapters implemented in MediaTek SoCs). \n                               : Turn off Wi-Fi in the system settings before using this.\n  --dts, --dont-touch-settings : Don't touch the Android Wi-Fi settings on startup and exit.\n                               : Use when having device-specific issues\n  --iface-down                 : Down network interface when the work is finished\n  -v, --verbose                : Verbose output\n  -h, --help                   : show this help message and exit\n ```\n\n# Installation\n\n## Termux\n**Please note that root access is required.**  \n\n**Installing requirements**\n ```shell\n pkg install -y root-repo\n pkg install -y git tsu python wpa-supplicant pixiewps iw openssl\n ```\n**Getting OneShot-Extended**\n ```shell\n cd ~\n git clone --depth 1 https://github.com/chickendrop89/OneShot-Extended ose\n ```\n**Running**\n ```shell\n sudo python ose/ose.py -i wlan0\n ```\n\n## Linux distributions \n**Install these packages through your distro's package manager:**\n ```shell\n python3 wpa-supplicant iw wget pixiewps\n ```\n \n**Getting OneShot**\n ```shell\n cd ~\n git clone --depth 1 https://github.com/chickendrop89/OneShot-Extended ose\n ```\n**Running**\n ```shell\n sudo python ose/ose.py -i wlan0\n ```\n\n# Update procedure\n1. Change directory to where OneShot-Extended is cloned\n```\ncd OneShot-Extended\n```\n\n2. Update via git to latest commit, this will revert any local changes\n```\ngit fetch\ngit reset --hard origin/master\n```\n\n# Troubleshooting\n\n### `Device or resource busy (-16)`\nThis happens because something else is trying to use the interface (Wi-Fi scanner/Network managers)\n\n- Android: try re-running the tool few times\n- Linux: try disabling Wi-Fi in the system settings, and kill the Network manager.\n- Alternatively: you can try running OneShot-Extended with ```--iface-down``` argument.\n\n### The wlan0 interface disappears when Wi-Fi is disabled on Android devices with MediaTek SoC\n- Try running Oneshot-Extended with the `--mtk-wifi` flag to initialize Wi-Fi device driver.\n\n# Acknowledgements\n* `kimocoder, drygdryg` for the foundation of this project\n* `rofl0r` for original oneshot\n\n-----\n\n\u003e [!WARNING] \n\u003e This tool is intended for educational and authorized penetration testing purposes only.\n\u003e It is not designed for, and must not be used for, illegal activities such as hacking, unauthorized access, or causing damage to systems or networks.\n\u003e By using this tool, you agree to use it responsibly and ethically, and to comply with all applicable laws and regulations.\n\u003e The developer assumes no responsibility for any misuse of this tool.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchickendrop89%2Foneshot-extended","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchickendrop89%2Foneshot-extended","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchickendrop89%2Foneshot-extended/lists"}