mirror of
https://github.com/k4m4/kickthemout.git
synced 2024-11-23 05:24:24 +01:00
🎉 v2.0 release!!!
This commit is contained in:
k4m4
parent
0099733382
commit
993ec221e3
1
.gitignore
vendored
1
.gitignore
vendored
@ -25,3 +25,4 @@ ENV/
|
||||
*.tmp
|
||||
*.bak
|
||||
*.cfg
|
||||
__pycache__/
|
||||
@ -1,6 +1,9 @@
|
||||
language: python
|
||||
python:
|
||||
- "2.6"
|
||||
- "2.7"
|
||||
- "3.4"
|
||||
- "3.5"
|
||||
- "3.6"
|
||||
install:
|
||||
- pip3 install -r requirements.txt
|
||||
script:
|
||||
- python -c "import kickthemout; import scan; import spoof"
|
||||
@ -1,4 +0,0 @@
|
||||
0.1 (05.01.2017)
|
||||
----------------
|
||||
|
||||
- Initial release.
|
||||
2
LICENSE
2
LICENSE
@ -1,6 +1,6 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2017 Nikolaos Kamarinakis
|
||||
Copyright (c) 2017-18 Nikolaos Kamarinakis
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
|
||||
109
README.rst
109
README.rst
@ -1,109 +0,0 @@
|
||||
.. image:: http://nikolaskama.me/content/images/2017/02/kickthemout_small.png
|
||||
|
||||
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://travis-ci.org/k4m4/kickthemout.svg?branch=master
|
||||
:target: https://travis-ci.org/k4m4/kickthemout
|
||||
.. image:: https://img.shields.io/badge/license-MIT-blue.svg
|
||||
:target: https://github.com/k4m4/kickthemout/blob/master/LICENSE
|
||||
.. image:: https://img.shields.io/badge/made%20with-%3C3-red.svg
|
||||
:target: https://nikolaskama.me/kickthemoutproject
|
||||
.. image:: https://img.shields.io/github/stars/k4m4/kickthemout.svg
|
||||
:target: https://github.com/k4m4/kickthemout/stargazers
|
||||
|
||||
-------------
|
||||
|
||||
Debian Installation
|
||||
----------------------
|
||||
|
||||
You can download KickThemOut by cloning the `Git Repo <https://github.com/k4m4/kickthemout>`_ and simply installing its requirements::
|
||||
|
||||
$ sudo apt-get update && sudo apt-get install nmap
|
||||
|
||||
$ git clone https://github.com/k4m4/kickthemout.git
|
||||
|
||||
$ cd kickthemout/
|
||||
|
||||
$ sudo -H pip install --upgrade pip
|
||||
|
||||
$ sudo -H python -m pip install -r requirements.txt
|
||||
|
||||
$ sudo python kickthemout.py
|
||||
|
||||
MacOS Installation
|
||||
----------------------
|
||||
|
||||
If you would like to install KickThemOut on a Mac, please run the following::
|
||||
|
||||
$ sudo -H pip install --upgrade pip
|
||||
|
||||
$ sudo -H pip install pcapy
|
||||
|
||||
$ brew update
|
||||
|
||||
$ brew install --with-python libdnet nmap
|
||||
|
||||
**Keep in mind** that you might be asked to run some commands after executing the previous step. Moving on::
|
||||
|
||||
$ git clone https://github.com/k4m4/kickthemout.git
|
||||
|
||||
$ cd kickthemout/
|
||||
|
||||
$ sudo -H pip install -r requirements.txt
|
||||
|
||||
$ sudo python kickthemout.py
|
||||
|
||||
**NOTE**: You need to have `Homebrew <http://brew.sh/>`_ installed before running the Mac OS installation.
|
||||
|
||||
Arch Installation
|
||||
----------------------
|
||||
|
||||
You can download KickThemOut on an Arch based system by executing the following::
|
||||
|
||||
$ yaourt -S kickthemout-git
|
||||
|
||||
$ sudo kickthemout
|
||||
|
||||
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>`_.)
|
||||
|
||||
Developers
|
||||
-----------
|
||||
|
||||
* Nikolaos Kamarinakis - `@nikolaskama <https://twitter.com/nikolaskama>`_
|
||||
* David Schütz - `@xdavidhu <https://twitter.com/xdavidhu>`_
|
||||
|
||||
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**.
|
||||
935
kickthemout.py
935
kickthemout.py
File diff suppressed because it is too large
Load Diff
142
readme.md
Normal file
142
readme.md
Normal file
@ -0,0 +1,142 @@
|
||||
|
||||
|
||||
# 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 **3+**🎉.
|
||||
|
||||
- *Not* compatible with Windows.
|
||||
|
||||
Authors: [Nikolaos Kamarinakis](mailto:nikolaskam@gmail.com) & [David Schütz](mailto:xdavid@protonmail.com).
|
||||
|
||||
[](https://travis-ci.org/k4m4/kickthemout)
|
||||
[](https://github.com/k4m4/kickthemout/blob/master/LICENSE)
|
||||
[](https://github.com/k4m4/kickthemout/stargazers)
|
||||
|
||||
-------------
|
||||
|
||||
# Installation
|
||||
|
||||
## Debian Installation
|
||||
|
||||
You can download KickThemOut by cloning the [Git Repo](https://github.com/k4m4/kickthemout) 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
|
||||
|
||||
~ ❯❯❯ 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](http://brew.sh/) installed before running the Mac OS installation.
|
||||
|
||||
Also, **keep in mind** that you might be asked to run some commands after executing the 2nd last command.
|
||||
|
||||
|
||||
## Arch Installation
|
||||
|
||||
You can download KickThemOut on an Arch based system by executing the following:
|
||||
|
||||
```
|
||||
~ ❯❯❯ git clone https://github.com/k4m4/kickthemout.git
|
||||
|
||||
~ ❯❯❯ cd kickthemout/
|
||||
|
||||
~ ❯❯❯ sudo -H pip3 install -r requirements.txt
|
||||
|
||||
~/kickthemout ❯❯❯ sudo python3 kickthemout.py
|
||||
```
|
||||
|
||||
<br/>
|
||||
|
||||
# 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
|
||||
```
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
# Demo
|
||||
|
||||
Here's a short demo:
|
||||
|
||||
[](https://asciinema.org/a/98200?autoplay=1&loop=1)
|
||||
|
||||
(For more demos click [here](https://asciinema.org/~k4m4))
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
# Developers
|
||||
|
||||
* Nikolaos Kamarinakis - [@nikolaskama](https://twitter.com/nikolaskama)
|
||||
* David Schütz - [@xdavidhu](https://twitter.com/xdavidhu)
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
# 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.
|
||||
|
||||
|
||||
<br/>
|
||||
|
||||
# License
|
||||
|
||||
Copyright (c) 2017-18 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**.
|
||||
@ -1,2 +1,3 @@
|
||||
scapy
|
||||
scapy-python3
|
||||
python-nmap
|
||||
netifaces
|
||||
18
scan.py
18
scan.py
@ -1,21 +1,25 @@
|
||||
#!/usr/bin/env python
|
||||
#!/usr/bin/env python3
|
||||
# -.- coding: utf-8 -.-
|
||||
# scan.py
|
||||
# authors: k4m4 & xdavidhu
|
||||
|
||||
"""
|
||||
Copyright (C) 2017-18 Nikolaos Kamarinakis (nikolaskam@gmail.com) & David Schütz (xdavid@protonmail.com)
|
||||
See License at nikolaskama.me (https://nikolaskama.me/kickthemoutproject)
|
||||
"""
|
||||
|
||||
import nmap
|
||||
|
||||
# perform a network scan with nmap
|
||||
def scanNetwork(network):
|
||||
# Function for performing a network scan with nmap with the help of the python-nmap module
|
||||
returnlist = []
|
||||
import nmap
|
||||
nm = nmap.PortScanner()
|
||||
a = nm.scan(hosts=network, arguments='-sP')
|
||||
a = nm.scan(hosts=network, arguments='-sn')
|
||||
|
||||
for k, v in a['scan'].iteritems():
|
||||
for k, v in a['scan'].items():
|
||||
if str(v['status']['state']) == 'up':
|
||||
try:
|
||||
returnlist.append([str(v['addresses']['ipv4']), str(v['addresses']['mac'])])
|
||||
except:
|
||||
pass
|
||||
|
||||
# returnlist = hostsList array
|
||||
return returnlist
|
||||
|
||||
13
spoof.py
13
spoof.py
@ -1,10 +1,9 @@
|
||||
#!/usr/bin/env python
|
||||
#!/usr/bin/env python3
|
||||
# -.- coding: utf-8 -.-
|
||||
# spoof.py
|
||||
# authors: k4m4 & xdavidhu
|
||||
|
||||
"""
|
||||
Copyright (C) 2016 Nikolaos Kamarinakis (nikolaskam@gmail.com) & David Schütz (xdavid@protonmail.com)
|
||||
Copyright (C) 2017-18 Nikolaos Kamarinakis (nikolaskam@gmail.com) & David Schütz (xdavid@protonmail.com)
|
||||
See License at nikolaskama.me (https://nikolaskama.me/kickthemoutproject)
|
||||
"""
|
||||
|
||||
@ -15,11 +14,15 @@ from scapy.all import (
|
||||
getmacbyip,
|
||||
ARP,
|
||||
Ether,
|
||||
sendp
|
||||
sendp,
|
||||
conf,
|
||||
RadioTap,
|
||||
Dot11,
|
||||
Dot11Deauth
|
||||
)
|
||||
|
||||
# send malicious ARP packets
|
||||
def sendPacket(my_mac, gateway_ip, target_ip, target_mac):
|
||||
# Function for sending the malicious ARP packets out with the specified data
|
||||
ether = Ether()
|
||||
ether.src = my_mac
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user