Skip to content

Installation

Requirements

VIIPER relies on USBIP. You must have USBIP installed on your system.

Linux

Ubuntu/Debian

sudo apt install linux-tools-generic

Ubuntu USBIP Manual

Arch Linux

sudo pacman -S usbip

Arch Wiki: USBIP

Windows

usbip-win2 is by far the most complete implementation of USBIP for Windows (comes with a SIGNED kernel mode driver).

Installing VIIPER

Pre-built Binaries

Download the latest release from the GitHub Releases page.

Building from Source

Prerequisites

  • Go 1.25 or newer
  • USBIP installed
  • (Optional) Make
    • Linux/macOS: Usually pre-installed
    • Windows: winget install ezwinports.make

Build Steps

git clone https://github.com/Alia5/VIIPER.git
cd VIIPER
make build

The compiled binary will be in dist/viiper (or dist/viiper.exe on Windows).

Additional build targets:

make help          # Show all available make targets
make test          # Run tests