Skip to content
A tool for in-depth analysis of USB HID devices communication
C++ CMake Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
hidviz Release version 0.1.5 Dec 2, 2019
libhidx @ da37738 update libhidx to newest version Dec 2, 2019
media Add screenshot Apr 16, 2017
scripts improve release script Dec 2, 2019
.appveyor.yml Add AppVeyor CI May 2, 2017
.gitignore Update gitignore Nov 28, 2017
.gitmodules Move libhidx to independent repository Apr 8, 2017
.travis.yml update travis to bionic Dec 2, 2019
CMakeLists.txt Move main CMakeLists file to hidviz subdirectory Apr 8, 2017
Doxyfile
LICENSE Add GPL3 license May 5, 2017
README.md Add reference in README to package in AUR May 16, 2017

README.md

Hidviz

Build Status Build status

Hidviz is a GUI application for in-depth analysis of USB HID class devices. The 2 main usecases of this application are reverse-engineering existing devices and developing new USB HID devices.

USB HID class consists of many possible devices, e.g. mice, keyboards, joysticks and gamepads. But that's not all! There are more exotic HID devices, e.g. weather stations, medical equipment (thermometers, blood pressure monitors) or even simulation devices (think of flight sticks!).

Hidviz screenshot

1) Building

Hidviz can be built on various platforms where following prerequisities can be obtained. Currently only Fedora, Ubuntu and MSYS2/Windows are supported and build guide is available for them.

1.1) Prerequisities

  • C++ compiler with C++14 support
  • libusb 1.0 (can be called libusbx in you distro)
  • protobuf (v2 is enough)
  • Qt5 base
  • CMake (>=3.2)

1.1.1) Installing prerequisities on Fedora

sudo dnf install gcc-c++ gcc qt5-qtbase-devel protobuf-devel libusbx-devel

1.1.2) Installing prerequisities on Ubuntu

sudo apt-get install build-essential qtbase5-dev libprotobuf-dev protobuf-compiler libusb-1.0-0-dev

Note that Ubuntu 14.04 LTS has old gcc unable to build hidviz, you need to install at least gcc 5.

1.1.3) Installing prerequisities on MSYS2/Windows

Please note hidviz is primarily developed on Linux and we currently don't have Windows CI therefore Windows build can be broken at any time. If you find so, please create an issue.

If you do not have MSYS2 installed, firstly follow this guide to install MSYS2.

pacman -S git mingw-w64-x86_64-cmake mingw-w64-x86_64-qt5 mingw-w64-x86_64-libusb \
          mingw-w64-x86_64-protobuf mingw-w64-x86_64-protobuf-c mingw-w64-x86_64-toolchain \
          make

1.2) Clone and prepare out of source build

Firstly you need to obtain sources from git and prepare directory for out of source build:

git clone --recursive https://github.com/ondrejbudai/hidviz.git
mkdir hidviz/build
cd hidviz/build

Please note you have to do recursive clone.

1.3) Configuring

1.2.1) Configuring on Fedora/Ubuntu (Linux)

cmake ..

1.2.2) Configuring on MSYS2/Windows

cmake -G "Unix Makefiles" ..

1.4) Build

make -j$(nproc)

If you are doing MSYS2 build, check before build you are using MinGW32/64 shell, otherwise the build process won't work. More information can be found here.

2) Running

To run this project you need build/hidviz as you current directory for hidviz to work properly!

After successful build you need to run

cd hidviz
./hidviz

2.1) Running on Windows

Unfortunately you cannot use hidviz on Windows straight out of the box. Firstly you need to install custom drivers to devices you want to analyze.

I recommend you using following approach: Download Zadig, run it and install libusbK to device you want to analyze. You can find more information about the need for custom driver on Windows on libusb wiki.

3) Installing (Linux only)

sudo make install

Alternatively, you can install hidviz from Arch Linux's AUR repository:

pacaur -S hidviz

4) License

Hidviz is license under GPLv3+. For more information see LICENSE file.

You can’t perform that action at this time.