What's this?

Universal Radio Hacker is a suite for investigating unknown wireless protocols. Features include

  • hardware interfaces for common Software Defined Radios
  • easy demodulation of signals
  • assigning participants to keep overview of your data
  • customizable decodings to crack even sophisticated encodings like CC1101 data whitening
  • assign labels to reveal the logic of the protocol
  • fuzzing component to find security leaks
  • modulation support to inject the data back into the system

Check out the wiki for more information.

Installation

Requirements

  • Python 3.4+
  • numpy / psutil
  • PyQt5
  • C++ Compiler

Arch Linux

yaourt -S urh

Ubuntu/Debian

sudo apt-get update
sudo apt-get install python3-numpy python3-psutil python3-pyqt5 g++ libpython3-dev python3-pip
sudo pip3 install urh

Windows

  1. Install Visual C++ Build Tools
  2. Install Python 3.5 for Windows
  3. Open a terminal (cmd) and type: pip install urh
  4. Navigate to C:\Users\<Your-Username>\AppData\Local\Programs\Python\Python35\Scripts
  5. In a terminal (cmd) type python urh

From cloned repository

If you want to URH from a cloned repository you need to install python-setuptools first.

git clone https://github.com/jopohl/urh/
cd urh
sudo python setup.py install

Running from source

To execute the Universal Radio Hacker without installation, just run:

git clone https://github.com/jopohl/urh/
cd urh/bin
./urh

Note, before first usage the C++ extensions will be built.

Screenshots

Get the data out of raw signals

Interpreation phase

Keep an overview even on complex protocols

Analysis phase

Record and send signals

Record

Languages
Python 96.8%
Cython 2.7%
C 0.3%