Skip to main content

Universal Radio Hacker: investigate wireless protocols like a boss

Project description

Build Status Code Climate PyPI version Dependency Status

The Universal Radio Hacker is a software 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 and supported devices.

Like to see things in action? Watch URH on YouTube!

Youtube Image

Installation

Dependencies

Required

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

Optional

  • librtlsdr (for native RTL-SDR device backend)
  • libhackrf (for native HackRF device backend)
  • gnuradio / gnuradio-osmosdr (for GNU Radio device backends)

Arch Linux

yaourt -S urh

Ubuntu/Debian

If you want to use native backends for RTL-SDR or HackRF and installed these drivers using your packet manager, you need to create the appropriate symlink:

sudo ln -s /usr/lib/x86_64-linux-gnu/librtlsdr.so.0 /usr/lib/x86_64-linux-gnu/librtlsdr.so
sudo ln -s /usr/lib/x86_64-linux-gnu/libhackrf.so.0 /usr/lib/x86_64-linux-gnu/libhackrf.so

before installing URH, using:

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

Windows

  1. Install Visual C++ Build Tools.
  2. Install Python 3 for Windows. Choose a 64 Bit version!
  3. (Optional) Open a terminal (cmd) and type: pip install numpy - This speeds the installation up a bit.
  4. In a terminal, type: pip install urh.
  5. Type urh in a terminal or search for urh in search bar.

Mac OS X

  1. 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.
  2. (Optional) Install desired native libs e.g. brew install librtlsdr for corresponding native device support.
  3. In a terminal, type: pip3 install urh.
  4. Type urh in a terminal to get it started.

Updating

If you installed URH via pip you can keep it up to date with

pip3 install --upgrade urh

If this shouldn’t work you can try:

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

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

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

And start the application by typing urh in a terminal.

Screenshots

Get the data out of raw signals

Interpretation phase

Interpretation phase

Keep an overview even on complex protocols

Analysis phase

Analysis phase

Record and send signals

Record

Record

Project details


Release history Release notifications

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0.0

History Node

1.9.2

History Node

1.9.1

History Node

1.9.0

History Node

1.8.17

History Node

1.8.16

History Node

1.8.15

History Node

1.8.14

History Node

1.8.13

History Node

1.8.12

History Node

1.8.11

History Node

1.8.10

History Node

1.8.9

History Node

1.8.8

History Node

1.8.7

History Node

1.8.6

History Node

1.8.5

History Node

1.8.4

History Node

1.8.3

History Node

1.8.2

History Node

1.8.1

History Node

1.8.0

History Node

1.7.1

History Node

1.7.0

History Node

1.6.6

History Node

1.6.5.3

History Node

1.6.5.1

History Node

1.6.5

History Node

1.6.4.2

History Node

1.6.4.1

History Node

1.6.4

History Node

1.6.3

History Node

1.6.2.6

History Node

1.6.2.5

This version
History Node

1.6.2.4

History Node

1.6.2.3

History Node

1.6.2.2

History Node

1.6.2.1

History Node

1.6.2.0

History Node

1.6.1.9

History Node

1.6.1.8

History Node

1.6.1.7

History Node

1.6.1.6

History Node

1.6.1.5

History Node

1.6.1.4

History Node

1.6.1.3

History Node

1.6.1.2

History Node

1.6.1.1

History Node

1.6.1

History Node

1.6.0

History Node

1.5.7

History Node

1.5.6

History Node

1.5.5

History Node

1.5.4

History Node

1.5.3

History Node

1.5.2

History Node

1.5.1

History Node

1.5.0

History Node

1.4.10

History Node

1.4.9

History Node

1.4.8

History Node

1.4.7

History Node

1.4.6

History Node

1.4.5

History Node

1.4.4

History Node

1.4.2

History Node

1.4.1

History Node

1.4.0

History Node

1.3.10

History Node

1.3.9

History Node

1.3.8

History Node

1.3.7

History Node

1.3.5

History Node

1.3.4

History Node

1.3.3

History Node

1.3.2

History Node

1.3.1

History Node

1.3.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
urh-1.6.2.4.tar.gz (4.8 MB) Copy SHA256 hash SHA256 Source None Apr 21, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page