🎉 v2.0 release!!!

.gitignore

@@ -25,3 +25,4 @@ ENV/
 *.tmp
 *.bak
 *.cfg
+__pycache__/

.travis.yml

@@ -1,6 +1,9 @@
 language: python
 python:
-    - "2.6"
+    - "3.4"
-    - "2.7"
+    - "3.5"
+    - "3.6"
+install:
+    - pip3 install -r requirements.txt
 script:
     - python -c "import kickthemout; import scan; import spoof"

CHANGES.rst

@@ -1,4 +0,0 @@
-0.1 (05.01.2017)
-----------------
-
-- Initial release.

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

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**.

readme.md

@@ -0,0 +1,142 @@
+![KickThemOut Logo](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 **3+**🎉.
+
+- *Not* compatible with Windows.
+
+Authors: [Nikolaos Kamarinakis](mailto:nikolaskam@gmail.com) & [David Schütz](mailto:xdavid@protonmail.com).
+
+[![Build Badge](https://travis-ci.org/k4m4/kickthemout.svg?branch=master)](https://travis-ci.org/k4m4/kickthemout)
+[![License Badge](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/k4m4/kickthemout/blob/master/LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/k4m4/kickthemout.svg)](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:
+
+[![Asciinema Demo](https://nikolaskama.me/content/images/2017/01/kickthemout_asciinema.png)](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**.

requirements.txt

@@ -1,2 +1,3 @@
-scapy
+scapy-python3
 python-nmap
+netifaces

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

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