mirror of
https://github.com/jopohl/urh.git
synced 2026-03-11 02:36:48 +01:00
124 lines
4.4 KiB
Markdown
124 lines
4.4 KiB
Markdown
# Universal Radio Hacker
|
|
[](https://travis-ci.org/jopohl/urh)
|
|
[](https://ci.appveyor.com/project/jopohl/urh/branch/master)
|
|
[](https://codeclimate.com/github/jopohl/urh)
|
|
[](https://pypi.python.org/pypi/urh)
|
|
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6WDFF59DL56Z2)
|
|
|
|
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](https://github.com/jopohl/urh/wiki) for more information and supported devices.
|
|
|
|
Like to see things in action? Watch URH on YouTube!
|
|
|
|
[](https://www.youtube.com/watch?v=kuubkTDAxwA)
|
|
|
|
## 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)
|
|
- libairspy (for native AirSPy device backend)
|
|
- liblimesdr (for native LimeSDR device backend)
|
|
- rfcat (for RfCat plugin to send e.g. with YardStick One)
|
|
- gnuradio / gnuradio-osmosdr (for GNU Radio device backends)
|
|
|
|
### Arch Linux
|
|
```bash
|
|
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:
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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](http://landinghub.visualstudio.com/visual-cpp-build-tools).
|
|
2. Install [Python 3 for Windows](https://www.python.org/downloads/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](https://www.python.org/downloads/mac-osx/).
|
|
_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
|
|
```bash
|
|
pip3 install --upgrade urh
|
|
```
|
|
If this shouldn't work you can try:
|
|
```bash
|
|
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:
|
|
```bash
|
|
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:
|
|
```bash
|
|
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
|
|
|
|
|
|
|
|
### Keep an overview even on complex protocols
|
|
|
|
|
|
### Record and send signals
|
|
|