oneshot

OneShot 🎯

License: MIT Platform Python

OneShot is a powerful WiFi WPS penetration testing tool that performs Pixie Dust attacks without requiring monitor mode. Designed for rooted Android devices running Termux & Linux systems.

🚀 Quick Start (Termux)

One-Line Installation

Install OneShot with a single command on your rooted Android device:

curl -fsSL https://zahidoverflow.github.io/oneshot/install.sh | bash

Run

# Start
sudo oneshot

# Get help
sudo oneshot --help

# Auto-scan and attack with Pixie Dust
sudo oneshot -i wlan0 --iface-down -K

✨ Features

📋 Requirements

Rooted Android (Termux)

Linux Systems

🔧 Installation

Termux (Android)

curl -fsSL https://zahidoverflow.github.io/oneshot/install.sh | bash

What the installer does:

Manual Installation

# Install dependencies
pkg install -y root-repo
pkg install -y git tsu python wpa-supplicant pixiewps iw openssl
pip install wcwidth

# Clone repository
git clone --depth 1 https://github.com/zahidoverflow/oneshot.git
cd oneshot

# Run
sudo python3 oneshot.py -i wlan0 --iface-down -K

Debian/Ubuntu

# Install dependencies
sudo apt install -y python3 python3-pip wpasupplicant iw wget pixiewps

# Install Python module
pip3 install wcwidth

# Download OneShot
git clone --depth 1 https://github.com/zahidoverflow/oneshot.git
cd oneshot

# Run
sudo python3 oneshot.py -i wlan0 -K

Arch Linux

# Install dependencies
sudo pacman -S wpa_supplicant pixiewps wget python python-pip iw

# Install Python module
pip install wcwidth

# Download OneShot
git clone --depth 1 https://github.com/zahidoverflow/oneshot.git
cd oneshot

# Run
sudo python3 oneshot.py -i wlan0 -K

📖 Usage Guide

Basic Commands

# Run Pixie Dust attack (auto-scans networks)
sudo oneshot -i wlan0 --iface-down -K

# Attack specific BSSID
sudo oneshot -i wlan0 -b 00:90:4C:C1:AC:21 -K

# Online bruteforce with PIN
sudo oneshot -i wlan0 -b 00:90:4C:C1:AC:21 -B -p 1234

# WPS push button connection
sudo oneshot -i wlan0 --pbc

# Loop mode (continuous scanning)
sudo oneshot -i wlan0 -K -l

Command-Line Options

Required:
  -i, --interface <wlan0>     : WiFi interface to use

Optional:
  -b, --bssid <mac>           : Target AP BSSID
  -p, --pin <wps pin>         : Use specific PIN (4/8 digits)
  -K, --pixie-dust            : Run Pixie Dust attack
  -B, --bruteforce            : Run online bruteforce
  --pbc                       : WPS push button connection

Advanced:
  -d, --delay <n>             : Delay between attempts [0]
  -w, --write                 : Save credentials to file
  -F, --pixie-force           : Force full Pixiewps range
  -X, --show-pixie-cmd        : Show Pixiewps command
  --vuln-list <file>          : Custom vulnerability list
  --iface-down                : Shutdown interface on exit
  -l, --loop                  : Run in loop mode
  -r, --reverse-scan          : Reverse network order
  --mtk-wifi                  : MediaTek WiFi driver support
  -v, --verbose               : Verbose output

🛡️ Security & Legal

⚠️ Important Warning

This tool is for educational and authorized security testing purposes only.

Unauthorized access to computer networks is illegal in most countries. The developers assume no liability for misuse of this tool.

🐛 Troubleshooting

Permission Denied

# Grant root permissions
su

# Or use sudo
sudo oneshot -i wlan0 -K

WiFi Interface Not Found

# List available interfaces
sudo iw dev

# Use correct interface name
sudo oneshot -i wlan1 -K

Python Module Missing

# Reinstall with dependencies
curl -fsSL https://zahidoverflow.github.io/oneshot/install.sh | bash

# Unblock WiFi
sudo rfkill unblock wifi

# Or disable WiFi in settings and use --iface-down
sudo oneshot -i wlan0 --iface-down -K

MediaTek WiFi Issues

# Use MTK driver support
sudo oneshot -i wlan0 --mtk-wifi -K

🔄 Updates

Update OneShot

cd ~/oneshot
git pull origin main

Reinstall

curl -fsSL https://zahidoverflow.github.io/oneshot/install.sh | bash

Uninstall

# Remove files
rm -rf ~/oneshot
rm $PREFIX/bin/oneshot

🏗️ Architecture

Key Components

Supported Algorithms

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

git clone https://github.com/zahidoverflow/oneshot.git
cd oneshot
python3 oneshot.py -i wlan0 -K -v

Reporting Issues

Please include:

📚 Additional Resources

👥 Credits

Original Authors

This Fork

Special Thanks

📜 License

This project is licensed under the MIT License - see below for details.

MIT License

Copyright (c) 2025 zahidoverflow
Original work Copyright (c) 2017 rofl0r

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🔗 Links

📊 Statistics

### ⭐ Star this repository if you find it useful! **Made with ❤️ for the security research community**

Disclaimer: Use this tool responsibly and ethically. Always obtain proper authorization before testing network security. The authors and contributors are not responsible for any misuse or damage caused by this tool.

This site is open source. Improve this page.