RRW is a Wi‑Fi captive portal demo for authorized security labs, classroom exercises, and harmless pranks done with clear permission.
This project presents a network login page and then displays a fullscreen Rick Astley video after the user interacts with the page. It is intended only for controlled environments where you have explicit authorization to test or demonstrate captive portal behavior.
Use this project only in environments you own or are permitted to test.
Do not use it to:
- intercept traffic without consent
- impersonate public or private networks
- collect credentials or personal data
- disrupt third-party devices or networks
- Custom captive portal-style login page
- Mobile-friendly layout
- Configurable SSID and channel
- Local logging for lab use
- Easy cleanup on exit
Debian / Ubuntu / Kali:
sudo apt update
sudo apt install hostapd dnsmasq iptables python3 iwA Wi‑Fi adapter that supports Access Point mode.
Check support with:
iw list | grep -A 10 "Supported interface modes"Look for * AP in the output.
- Clone the repository:
git clone https://github.com/Ymsniper/RRW.git
cd RRW-
Configure the video path: Set
VIDEO_PATHinRRW.pyto the location of yourrickroll.mp4file. -
Run the script as root:
sudo python3 RRW.py- Follow the prompts:
- Enter the Wi‑Fi name
- Select the adapter
- Start the demo
- Stop the demo:
Press
Ctrl+Cto clean up background services and restore the system state.
Common settings in RRW.py:
VIDEO_PATH: path to the Rick Roll videoSSID: default Wi‑Fi nameCHANNEL: Wi‑Fi channel
- Some devices may show connection warnings in captive portal demos.
- On iOS / Safari, media playback may require a direct user gesture.
- Logs, if enabled, are stored locally for lab use.
MIT License. See the LICENSE file for details.
This project uses standard Python 3 libraries plus system dependencies listed above.