vs4vijay / swissarmypi

A set of utility/tools to make Raspberry Pi [Zero W] into Swiss Army Knife

SwissArmyPi

 o-o                           O                     o--o  o-O-o 
|              o              / \                    |   |   |   
 o-o  o   o   o  o-o o-o     o---oo-o o-O-o o  o     O--o    |   
    |  \ / \ / |  \   \      |   ||   | | | |  |     |       |   
o--o    o   o  | o-o o-o     o   oo   o o o o--O     o     o-O-o 
                                               |                 
                                            o--o                 

Hardware Required

• Raspberry Pi (I am using Raspberry Pi Zero W)
• SD Card (I am using 16 GB)
• MicroUSB Cable
• WiFi Card (The inbuilt Wireless Card doesn't support monitor mode by default, We need external wifi card. e.g. TP-LINK WN722N OR We need to patch kernel module & firmware using Nexmon)

.-------------------------.
| oooooooooooooooooooo J8 |
| 1ooooooooooooooooooo   |c
---+       +---+ PiZero W|s
 sd|       |SoC|   V1.1  |i
---+|hdmi| +---+  usb pwr |
`---|    |--------| |-| |-'

Basic Installation

• Download Linux Image, Options are:
  • Raspbian - https://www.raspberrypi.org/downloads/raspbian/
  • RetroPie - https://retropie.org.uk/download/
• Flash Image to SD Card using Etcher
• Configure SSH and Ethernet Gadget mode so that we can SSH into Pi using microusb cable
• Connect Pi with USB Cable via usb port(Pi Zero W has two microusb port: one for power, second for usb)
• Once Pi boots up, Run following commands to Configure & Update the system and depedencies:
  • sudo apt-get update

Use-Cases & Utilities

• WiFi Cracker (Patched Firmware Required, Please see below instructions)
  • sudo apt-get install aircrack-ng
  • sudo airmon-ng start wlan0
• reaver
• wifite
• Fake AP - Wifi Phishing
  • Wifiphisher - https://github.com/wifiphisher/wifiphisher
    • Need two wireless card
    • sudo apt-get install -y python-setuptools hostapd
    • sudo python setup.py install
    • sudo wifiphisher
  • Fluxion - https://github.com/FluxionNetwork/fluxion.git
• FM Transmitter - https://github.com/ChristopheJacquet/PiFmRds
• Metasploit - https://null-byte.wonderhowto.com/how-to/raspberry-pi-metasploit-0167798/
• Pi As Mass Storage
• Sniffing - bettercap
  • sudo apt-get install build-essential ruby-dev libpcap-dev net-tools
  • gem install bettercap
• WiFi Jammer/Deauther
  • kickthemout
  • https://github.com/DanMcInerney/LANs.py
• poinsontap
• USB Rubber Ducky
• War-driving
• BadUSB

To Patch Kernel Module and Firmware

• The Broadcom Chipsets(BCM*) that comes in Raspberry Pi doesn't support Monitor Mode, We need to install a patched kernel or use External WiFi Card. The instructions to patch kernel module can be found on Nexmon Repo.
• Nexmon - https://github.com/seemoo-lab/nexmon
• I have already put compiled kernel patch (*.ko) and firmware for Kernel 4.9.41 here: https://github.com/vs4vijay/SwissArmyPi/tree/master/4.9.41+

Extra Tools

• cmatrix
• python3-gpiozero
• mosh
• nmap - sudo apt-get install nmap

General Problems

• If keyboard layout is "gb", Set keyboard layout to "en" from file: sudo nano /etc/default/keyboard
• If nothing works, Just restart the Pi using sudo shutdown -r now

Other projects like this

• http://pwnpi.sourceforge.net/
• https://github.com/pwnieexpress/raspberry_pwn
• P4wnP1 - https://github.com/mame82/P4wnP1
• P4wnP1 ALOA - https://github.com/mame82/P4wnP1_aloa

Cool projects using Raspberry Pi

• MagicMirror - https://magicmirror.builders/
• RetroPie
• RaspberryCast - Use Raspberry Pi as Chromecast - https://github.com/vincelwt/RaspberryCast
• ZeroPhone - https://hackaday.io/project/19035-zerophone-a-raspberry-pi-smartphone
• KeySweeper - https://samy.pl/keysweeper/
• PirateBox - http://www.instructables.com/id/Raspberry-Pi-PirateBox/

swissarmypi's Issues

How do I install this?

Is this just a list of applications to install or is there some way I can install it all from a script

Pi hacking swiss army pi