urh/README.md

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. Install PyQt5 for Windows
4. Open a terminal (cmd) and type: pip install numpy
5. After that, type pip install urh
6. Navigate to C:\Users\<Your-Username>\AppData\Local\Programs\Python\Python35\Scripts
7. In a terminal (cmd) type python urh

From cloned repository

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

Keep an overview even on complex protocols

Record and send signals