The goal of this project is to provide an easy to use and cross-platform application which allows users to influence other devices’ network connection in the same WLAN/LAN. The functionality of this application is backed by ARP poisoning. The application will provide three modes:
- Kick other devices out:white_check_mark:: prevent other devices from accessing the WLAN/LAN.
- Speed limit:construction:: Reduce other devices’ network access speed. This is achieved by routing other devices' packets through your device, and selectively or randomly dropping certain portions of packets. (:warning:This mode is only avaliable on linux)
- Advanced:white_check_mark:: route other devices’ packets through your device, such that you can monitor other devices’ network activity.
node.js
, python
>= 3.0, scapy
(installed as a super user/administrator) and npm
is required to run this project in the development environment.
You should be able to run python in the terminal/powershell using command python3
, otherwise the app will crash when you are trying to stop the attack.
After clone the project, please use the following command to download dependencies.
npm install
Currently the project can only be ran in the development environment. A packaged application will be avaliable in the near future. Start the local server using
npm run start # npm run start-windows if your os is windows
Then start the application using
npm run electron
You need to run electron-rebulid after the installation.
For windows:
.\node_modules\.bin\electron-rebuild.cmd
For linux/macOS:
$(npm bin)/electron-rebuild
You need to remove all installed node_modules and then re-install them:
rm -r node_modules
npm install
- Loading Screen
- Main page
Libraries being used in this project
- electron
- network
- ping
- react
- react-dom
- react-scripts
- sudo-prompt
- web-vitals