{"id":13588220,"url":"https://github.com/vs4vijay/SwissArmyPi","last_synced_at":"2025-04-08T03:32:53.015Z","repository":{"id":52449709,"uuid":"101388250","full_name":"vs4vijay/SwissArmyPi","owner":"vs4vijay","description":"A set of utility/tools to make Raspberry Pi [Zero W] into Swiss Army Knife","archived":false,"fork":false,"pushed_at":"2019-05-20T07:15:28.000Z","size":555,"stargazers_count":254,"open_issues_count":2,"forks_count":22,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-10-30T03:31:09.346Z","etag":null,"topics":["chip","hacking","hacking-tool","internet-of-things","iot","iot-application","iot-platform","raspberry","raspberry-pi","raspberry-pi-3","raspberry-pi-iot","raspberry-pi-zero","retropie","robotics","swissarmyknife","wifi-cracker","wifi-security","wireless"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vs4vijay.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-25T09:23:01.000Z","updated_at":"2024-09-30T12:36:20.000Z","dependencies_parsed_at":"2022-09-06T10:22:26.818Z","dependency_job_id":null,"html_url":"https://github.com/vs4vijay/SwissArmyPi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vs4vijay%2FSwissArmyPi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vs4vijay%2FSwissArmyPi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vs4vijay%2FSwissArmyPi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vs4vijay%2FSwissArmyPi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vs4vijay","download_url":"https://codeload.github.com/vs4vijay/SwissArmyPi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223245058,"owners_count":17112572,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chip","hacking","hacking-tool","internet-of-things","iot","iot-application","iot-platform","raspberry","raspberry-pi","raspberry-pi-3","raspberry-pi-iot","raspberry-pi-zero","retropie","robotics","swissarmyknife","wifi-cracker","wifi-security","wireless"],"created_at":"2024-08-01T15:06:34.639Z","updated_at":"2024-11-06T07:31:05.658Z","avatar_url":"https://github.com/vs4vijay.png","language":"Shell","readme":"# SwissArmyPi\n\n```\n o-o                           O                     o--o  o-O-o \n|              o              / \\                    |   |   |   \n o-o  o   o   o  o-o o-o     o---oo-o o-O-o o  o     O--o    |   \n    |  \\ / \\ / |  \\   \\      |   ||   | | | |  |     |       |   \no--o    o   o  | o-o o-o     o   oo   o o o o--O     o     o-O-o \n                                               |                 \n                                            o--o                 \n ```\n\n### Hardware Required\n- **Raspberry Pi** (I am using **Raspberry Pi Zero W**)\n- **SD Card** (I am using 16 GB)\n- MicroUSB Cable\n- 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 \u0026 firmware](#to-patch-kernel-module-and-firmware) using [Nexmon](https://github.com/seemoo-lab/nexmon))\n\n```\n.-------------------------.\n| oooooooooooooooooooo J8 |\n| 1ooooooooooooooooooo   |c\n---+       +---+ PiZero W|s\n sd|       |SoC|   V1.1  |i\n---+|hdmi| +---+  usb pwr |\n`---|    |--------| |-| |-'\n```\n\n### Basic Installation\n- Download Linux Image, Options are:\n  - Raspbian - https://www.raspberrypi.org/downloads/raspbian/\n  - RetroPie - https://retropie.org.uk/download/\n- Flash Image to SD Card using [Etcher](https://etcher.io/)\n- Configure SSH and Ethernet Gadget mode so that we can SSH into Pi using microusb cable\n- Connect Pi with USB Cable via usb port(Pi Zero W has two microusb port: one for power, second for usb)\n- Once Pi boots up, Run following commands to Configure \u0026 Update the system and depedencies:\n  - `sudo apt-get update`\n\n\n### Use-Cases \u0026 Utilities\n- WiFi Cracker (Patched Firmware Required, Please see below instructions)\n  - `sudo apt-get install aircrack-ng`\n  - `sudo airmon-ng start wlan0`\n- `reaver`\n- `wifite`\n- Fake AP - Wifi Phishing\n  - Wifiphisher - https://github.com/wifiphisher/wifiphisher\n    - **Need two wireless card**\n    - `sudo apt-get install -y python-setuptools hostapd`\n    - `sudo python setup.py install`\n    - `sudo wifiphisher`\n  - Fluxion - https://github.com/FluxionNetwork/fluxion.git\n- FM Transmitter - https://github.com/ChristopheJacquet/PiFmRds\n- Metasploit - https://null-byte.wonderhowto.com/how-to/raspberry-pi-metasploit-0167798/\n- Pi As Mass Storage\n- Sniffing - `bettercap`\n  - `sudo apt-get install build-essential ruby-dev libpcap-dev net-tools`\n  - `gem install bettercap`\n- WiFi Jammer/Deauther \n  - `kickthemout`\n  - https://github.com/DanMcInerney/LANs.py\n- `poinsontap`\n- USB Rubber Ducky\n- War-driving\n- BadUSB\n\n\n### To Patch Kernel Module and Firmware\n- 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.\n- Nexmon - https://github.com/seemoo-lab/nexmon\n- 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+\n\n\n### Extra Tools\n- cmatrix\n- python3-gpiozero\n- mosh\n- nmap - `sudo apt-get install nmap`\n\n\n### General Problems\n- If keyboard layout is \"gb\", Set keyboard layout to \"en\" from file: `sudo nano /etc/default/keyboard`\n- If nothing works, Just restart the Pi using `sudo shutdown -r now`\n\n\n### Other projects like this\n- http://pwnpi.sourceforge.net/\n- https://github.com/pwnieexpress/raspberry_pwn\n- P4wnP1 - https://github.com/mame82/P4wnP1\n- P4wnP1 ALOA - https://github.com/mame82/P4wnP1_aloa\n\n\n### Cool projects using Raspberry Pi\n- MagicMirror - https://magicmirror.builders/\n- RetroPie\n- RaspberryCast - Use Raspberry Pi as Chromecast - https://github.com/vincelwt/RaspberryCast\n- ZeroPhone - https://hackaday.io/project/19035-zerophone-a-raspberry-pi-smartphone\n- KeySweeper - https://samy.pl/keysweeper/\n- PirateBox - http://www.instructables.com/id/Raspberry-Pi-PirateBox/\n- \n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvs4vijay%2FSwissArmyPi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvs4vijay%2FSwissArmyPi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvs4vijay%2FSwissArmyPi/lists"}