k4m4/kickthemout

💤 Kick devices off your network by performing an ARP Spoof attack.

Python

2,679

210 commits

updated Feb 27, 2023

See the code

README

KickThemOut Logo

KickThemOut

KickThemOut - Kick Devices Off Your Network

A tool to kick devices out of your network and enjoy all the bandwidth for yourself. It allows you to select specific or all devices and ARP spoofs them off your local area network.

  • Compatible with Python 3+ 🎉.

  • Not compatible with Windows.

Authors: Nikolaos Kamarinakis & David Schütz.

Build Badge License Badge Compatibility GitHub Stars


✨Read my latest post: KickThemout v2.0! 🎉


Installation

Debian Installation

You can download KickThemOut by cloning the Git Repo and simply installing its requirements:

~ ❯❯❯ sudo apt-get update && sudo apt-get install nmap

~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git

~ ❯❯❯ cd kickthemout/

~/kickthemout ❯❯❯ sudo -H pip3 install -r requirements.txt

~/kickthemout ❯❯❯ sudo python3 kickthemout.py

MacOS Installation

If you would like to install KickThemOut on a Mac, please run the following:

~ ❯❯❯ brew install libdnet nmap

~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git

~ ❯❯❯ cd kickthemout/

~/kickthemout ❯❯❯ sudo -H pip3 install -r requirements.txt

~/kickthemout ❯❯❯ sudo python3 kickthemout.py

NOTE: You need to have Homebrew installed before running the Mac OS installation.

Also, keep in mind that you might be asked to run some extra commands after executing the pip requirement installation.

ArchLinux Installation

You can download KickThemOut on an Arch based system by executing the following:

~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git

~ ❯❯❯ cd kickthemout/

~/kickthemout ❯❯❯ sudo -H pip3 install -r requirements.txt

~/kickthemout ❯❯❯ sudo python3 kickthemout.py

Usage

Usage: sudo python3 kickthemout.py [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -p PACKETS, --packets=PACKETS
                        number of packets broadcasted per minute (default: 6)
  -s, --scan            perform a quick network scan and exit
  -t TARGETS, --target=TARGETS
                        specify target IP address(es) and perform attack

Examples:
  sudo python3 kickthemout.py --target 192.168.1.10 
  sudo python3 kickthemout.py -t 192.168.1.5,192.168.1.10 -p 30
  sudo python3 kickthemout.py (interactive mode)

To view all available options run:

~/kickthemout ❯❯❯ sudo python3 kickthemout.py -h

Demo

Here's a short demo:

Asciinema Demo

(For more demos click here)


Developers


Disclaimer

KickThemOut is provided as is under the MIT Licence (as stated below). It is built for educational purposes only. If you choose to use it otherwise, the developers will not be held responsible. Please, do not use it with evil intent.


License

Copyright (c) 2017-18 by Nikolaos Kamarinakis & David Schütz. Some rights reserved.

KickThemOut is under the terms of the MIT License, following all clarifications stated in the license file.

For more information head over to the official project page. You can also go ahead and email me anytime at nikolaskam{at}gmail{dot}com or David at xdavid{at}protonmail{dot}com.

hacking
python
spoofing
wifi
wireless

k4m4/kickthemout

💤 Kick devices off your network by performing an ARP Spoof attack.

Python

2,679

210 commits

updated Feb 27, 2023

See the code

README

KickThemOut Logo

KickThemOut

KickThemOut - Kick Devices Off Your Network

A tool to kick devices out of your network and enjoy all the bandwidth for yourself. It allows you to select specific or all devices and ARP spoofs them off your local area network.

  • Compatible with Python 3+ 🎉.

  • Not compatible with Windows.

Authors: Nikolaos Kamarinakis & David Schütz.

Build Badge License Badge Compatibility GitHub Stars


✨Read my latest post: KickThemout v2.0! 🎉


Installation

Debian Installation

You can download KickThemOut by cloning the Git Repo and simply installing its requirements:

~ ❯❯❯ sudo apt-get update && sudo apt-get install nmap

~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git

~ ❯❯❯ cd kickthemout/

~/kickthemout ❯❯❯ sudo -H pip3 install -r requirements.txt

~/kickthemout ❯❯❯ sudo python3 kickthemout.py

MacOS Installation

If you would like to install KickThemOut on a Mac, please run the following:

~ ❯❯❯ brew install libdnet nmap

~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git

~ ❯❯❯ cd kickthemout/

~/kickthemout ❯❯❯ sudo -H pip3 install -r requirements.txt

~/kickthemout ❯❯❯ sudo python3 kickthemout.py

NOTE: You need to have Homebrew installed before running the Mac OS installation.

Also, keep in mind that you might be asked to run some extra commands after executing the pip requirement installation.

ArchLinux Installation

You can download KickThemOut on an Arch based system by executing the following:

~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git

~ ❯❯❯ cd kickthemout/

~/kickthemout ❯❯❯ sudo -H pip3 install -r requirements.txt

~/kickthemout ❯❯❯ sudo python3 kickthemout.py

Usage

Usage: sudo python3 kickthemout.py [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -p PACKETS, --packets=PACKETS
                        number of packets broadcasted per minute (default: 6)
  -s, --scan            perform a quick network scan and exit
  -t TARGETS, --target=TARGETS
                        specify target IP address(es) and perform attack

Examples:
  sudo python3 kickthemout.py --target 192.168.1.10 
  sudo python3 kickthemout.py -t 192.168.1.5,192.168.1.10 -p 30
  sudo python3 kickthemout.py (interactive mode)

To view all available options run:

~/kickthemout ❯❯❯ sudo python3 kickthemout.py -h

Demo

Here's a short demo:

Asciinema Demo

(For more demos click here)


Developers


Disclaimer

KickThemOut is provided as is under the MIT Licence (as stated below). It is built for educational purposes only. If you choose to use it otherwise, the developers will not be held responsible. Please, do not use it with evil intent.


License

Copyright (c) 2017-18 by Nikolaos Kamarinakis & David Schütz. Some rights reserved.

KickThemOut is under the terms of the MIT License, following all clarifications stated in the license file.

For more information head over to the official project page. You can also go ahead and email me anytime at nikolaskam{at}gmail{dot}com or David at xdavid{at}protonmail{dot}com.

hacking
python
spoofing
wifi
wireless

Project health

Overall

2.1/10

Maintained

0/10

Code review

1/10
OpenSSF Scorecard

Significant stargazers

Michał Ży

5,857 followers · starred Feb 2018

Arun Prakash Jana

2,609 followers · starred May 2018

Andrew Bradley

147 followers · starred Jan 2024

Rico Antonio Felix

34 followers · starred Mar 2017