mirror of
https://github.com/k4m4/kickthemout.git
synced 2025-02-22 10:29:20 +01:00
00fd583e4a
# This is the 1st commit message: Added Usage guide # The commit message #2 will be skipped: # Added Usage guide
102 lines
2.7 KiB
ReStructuredText
102 lines
2.7 KiB
ReStructuredText
KickThemOut
|
|
============
|
|
|
|
`KickThemOut <https://nikolaskama.me/kickthemoutproject/>`_ - **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 2.6 & 2.7.
|
|
|
|
Authors: `Nikolaos Kamarinakis <mailto:nikolaskam@gmail.com>`_ & `David Schütz <mailto:xdavid@protonmail.com>`_.
|
|
|
|
.. image:: https://nikolaskama.me/content/images/2017/01/kickthemout.png
|
|
|
|
Installation
|
|
-------------
|
|
|
|
You can download KickThemOut by cloning the `Git Repo <https://github.com/k4m4/kickthemout>`_ and simply installing its requirements::
|
|
|
|
$ git clone https://github.com/k4m4/kickthemout.git
|
|
|
|
$ cd kickthemout
|
|
|
|
$ pip install -r requirements.txt
|
|
|
|
|
|
Installation For Mac Os X
|
|
--------------------------
|
|
|
|
Clone `Git Repo <https://github.com/k4m4/kickthemout>`_ ::
|
|
|
|
$ git clone https://github.com/k4m4/kickthemout.git
|
|
|
|
$ cd kickthemout
|
|
|
|
Install Os X requirements::
|
|
|
|
$ pip install -r requirements_for_osx.txt
|
|
|
|
Install `libdnet <http://libdnet.sourceforge.net>`_ ::
|
|
|
|
Using Homebrew::
|
|
|
|
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
|
|
|
|
$ brew update
|
|
|
|
$ brew install libdnet
|
|
|
|
From source::
|
|
|
|
$ wget http://ftp.psu.ac.th/pub/snort/libdnet-1.12.tgz
|
|
|
|
$ tar xfz libdnet-1.12.tgz
|
|
|
|
$ ./configure
|
|
|
|
$ make
|
|
|
|
$ sudo make install
|
|
|
|
$ cd python 2.x setup.py install
|
|
|
|
|
|
Usage
|
|
-----
|
|
|
|
Run `kickthemout` with `sudo` privileges:
|
|
|
|
::
|
|
|
|
$ sudo python kickthemout.py
|
|
|
|
|
|
Demo
|
|
-----
|
|
|
|
Here's a short demo:
|
|
|
|
.. image:: https://nikolaskama.me/content/images/2017/01/kickthemout_asciinema.png
|
|
:target: https://asciinema.org/a/98200?autoplay=1&loop=1
|
|
|
|
(For more demos click `here <https://asciinema.org/~k4m4>`_.)
|
|
|
|
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.
|
|
In brief, do not use it with evil intent.
|
|
|
|
License
|
|
--------
|
|
|
|
Copyright (c) 2017 by `Nikolaos Kamarinakis <mailto:nikolaskam@gmail.com>`_ & `David Schütz <mailto:xdavid@protonmail.com>`_. Some rights reserved.
|
|
|
|
KickThemOut is under the terms of the `MIT License <https://www.tldrlegal.com/l/mit>`_, following all clarifications stated in the `license file <https://raw.githubusercontent.com/k4m4/kickthemout/master/LICENSE>`_.
|
|
|
|
|
|
For more information head over to the `official project page <https://nikolaskama.me/kickthemoutproject/>`_.
|
|
You can also go ahead and email me anytime at **nikolaskam{at}gmail{dot}com** or David at **xdavid{at}protonmail{dot}com**.
|