The Universal Radio Hacker is a software for investigating unknown wireless protocols. Features include
Video
Installation
Universal Radio Hacker can be installed via pip or using the package manager of your distribution (if included). Furthermore, you can install urh from source or run it without installation directly from source.
Dependencies
Installation examples
Arch Linux
Ubuntu/Debian
If you want to use native device backends, make sure you install the -dev package for your desired SDRs, that is:
before installing URH, using:
Gentoo/Pentoo
Fedora 25+
Windows
If you run Python 3.4 on Windows you need to install Visual C++ Build Tools 2015 first.
It is recommended to use Python 3.5 or later on Windows, so no C++ compiler needs to be installed.
Mac OS X
Update your installation
If you installed URH via pip you can keep it up to date with
If this shouldn't work you can try:
Running from source
If you like to live on bleeding edge, you can run URH from source.
Without installation
To execute the Universal Radio Hacker without installation, just run:
Note, before first usage the C++ extensions will be built.
Installing from source
To install from source you need to have
And start the application by typing
External decodings
See wiki for a list of external decodings provided by our community! Thanks for that!
Screenshots
Get the data out of raw signals
Keep an overview even on complex protocols
Record and send signals
- 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
Video
Installation
Universal Radio Hacker can be installed via pip or using the package manager of your distribution (if included). Furthermore, you can install urh from source or run it without installation directly from source.
Dependencies
- Python 3.4+
- numpy / psutil / zmq
- PyQt5
- C++ Compiler
- librtlsdr (for native RTL-SDR device backend)
- libhackrf (for native HackRF device backend)
- libairspy (for native AirSPy device backend)
- liblimesdr (for native LimeSDR device backend)
- libuhd (for native USRP device backend)
- rfcat (for RfCat plugin to send e.g. with YardStick One)
- gnuradio / gnuradio-osmosdr (for GNU Radio device backends)
Installation examples
Arch Linux
yaourt -S urh
Ubuntu/Debian
If you want to use native device backends, make sure you install the -dev package for your desired SDRs, that is:
- AirSpy:
libairspy-dev
- HackRF:
libhackrf-dev
- RTL-SDR:
librtlsdr-dev
- USRP:
libuhd-dev
-dev
package, e.g. LimeSDR, you need to manually create a symlink to the .so
, like this:sudo ln -s /usr/lib/x86_64-linux-gnu/libLimeSuite.so.17.02.2 /usr/lib/x86_64-linux-gnu/libLimeSuite.so
sudo apt-get update
sudo apt-get install python3-numpy python3-psutil python3-zmq python3-pyqt5 g++ libpython3-dev python3-pip
sudo pip3 install urh
Gentoo/Pentoo
emerge -av urh
Fedora 25+
dnf install urh
Windows
If you run Python 3.4 on Windows you need to install Visual C++ Build Tools 2015 first.
It is recommended to use Python 3.5 or later on Windows, so no C++ compiler needs to be installed.
- Install Python 3 for Windows.
- Make sure you tick the Add Python to PATH checkbox on first page in Python installer.
- Choose a 64 Bit Python version for native device support.
- In a terminal, type:
pip install urh
. - Type
urh
in a terminal or search forurh
in search bar to start the application.
Mac OS X
- Install Python 3 for Mac OS X. If you experience issues with preinstalled Python, make sure you update to a recent version using the given link.
- (Optional) Install desired native libs e.g.
brew install librtlsdr
for corresponding native device support. - In a terminal, type:
pip3 install urh
. - Type
urh
in a terminal to get it started.
Update your installation
If you installed URH via pip you can keep it up to date with
pip3 install --upgrade urh
python3 -m pip install --upgrade urh
Running from source
If you like to live on bleeding edge, you can run URH from source.
Without installation
To execute the Universal Radio Hacker without installation, just run:
git clone https://github.com/jopohl/urh/
cd urh/src/urh
./main.py
Installing from source
To install from source you need to have
python-setuptools
installed. You can get it e.g. with pip install setuptools
. Once the setuptools are installed use:git clone https://github.com/jopohl/urh/
cd urh
python setup.py install
urh
in a terminal.External decodings
See wiki for a list of external decodings provided by our community! Thanks for that!
Screenshots
Get the data out of raw signals
Keep an overview even on complex protocols
Record and send signals