Welcome to the Arper project! 🚀
Arper is a BETA project designed to demonstrate ARP poisoning and packet sniffing using Python and Scapy. This project is still under development and will continue to evolve, with new features and improvements added over time.
This tool is intended for educational and research purposes only. The authors are not responsible for any misuse or damage caused by this program. Always ensure you have explicit permission before testing on any networks or devices you don't own.
- ARP poisoning
- Packet sniffing
- Real-time packet analysis
- Cross-platform support (Windows, Linux, macOS)
To get started with Arper, follow these steps:
- Clone the repository:
git clone https://github.com/scrollDynasty/arp-snif
- Change to the project directory:
cd arper
- Install dependencies:
pip install -r requirements.txt
Basic usage:
sudo python3 arper.py <victim_ip> <gateway_ip> <interface>
Example:
sudo python3 arper.py 192.168.100.3 192.168.100.13 wlan0
- Python 3.x
- Scapy library
- Root/Administrator privileges
- Network interface in monitor mode
We welcome contributions to improve and expand Arper! If you have ideas, bug reports, or feature requests, please:
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
MIT License
Copyright (c) 2025 scrollDynasty
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.
A big thank you to:
- The open-source community for their invaluable tools and resources
- All contributors who help improve this project
- Scapy development team for their excellent packet manipulation library
Stay tuned for more updates as we continue to develop and enhance Arper! 💻✨
Made with ❤️ by scrollDynasty