# Install usbredir with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

USB traffic redirection library. Version 0.15.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:usbredir
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install usbredir
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install usbredir
```

  Evidence: MacPorts ports tree: devel/usbredir/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add libusbredirhost
```

  Evidence: Alpine Linux edge package indexes: libusbredirhost from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install libusbredirhost-dev
```

  Evidence: Debian stable package indexes: libusbredirhost-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install usbredir
```

  Evidence: Fedora Rawhide package metadata: usbredir from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#usbredir
```

  Evidence: nixpkgs package indexes: pkgs/by-name/us/usbredir/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S usbredir
```

  Evidence: Arch Linux sync databases: usbredir from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install libusbredirhost1
```

  Evidence: openSUSE Tumbleweed package metadata: libusbredirhost1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:usbredir
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/usbredir>
- **Version:** 0.15.0
- **Source summary:** USB traffic redirection library
- **Homepage:** <https://www.spice-space.org>
- **Repository:** <https://gitlab.freedesktop.org/spice/usbredir>
- **Upstream docs:** <https://gitlab.freedesktop.org/spice/usbredir>
- **License:** GPL-2.0-or-later AND LGPL-2.0-or-later
- **Source archive:** <https://www.spice-space.org/download/usbredir/usbredir-0.15.0.tar.xz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- usbredirect (cli)
- usbredirect (alias)

## Dependencies

- glib
- libusb

## Build dependencies

- meson
- ninja
- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.15.0
- Local data: ok
- Upstream repository: https://www.spice-space.org
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

usbredir is both a network protocol for forwarding USB device traffic and the software package that implements it. The SPICE project documentation describes a parser library, a host-side library, and utilities that let a USB device attached to one machine appear inside another, commonly a virtual machine.

### Project history

The official Git history begins with an initial usbredir import on 2011-02-03. The protocol documentation records version 0.2 as the version demonstrated at FOSDEM 2011 and version 0.3, released on 2011-07-14, as the first stable version intended for later compatibility.

Although created for SPICE, the SPICE documentation explicitly says the protocol and usbredirhost library are independent of SPICE. That separation is important historically: usbredir became a reusable USB-over-network mechanism rather than only a private detail of one remote desktop stack.

The protocol continued to evolve through the early 2010s. The official protocol document records filtering support in version 0.4 in 2012, 64-bit packet IDs in 0.5, buffered bulk input in 0.6, and protocol version 0.7 in 2014 with bulk-stream changes.

### Adoption history

usbredir's main adoption path was virtualization. The SPICE page documents use with QEMU, libvirt, virt-manager, remote-viewer, and Windows clients using UsbDk, while also noting that the guest side is implemented for QEMU and shipped as part of QEMU.

The input package metadata lists usbredir across Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Ubuntu, and openSUSE package families. That spread matches its role as a low-level library used by virtualization stacks rather than as a daily end-user command.

### How it is used

On the host side, applications provide a libusb device handle and callbacks for transporting usbredir data, then monitor usbredir and libusb events. The `usbredirect` utility can export a USB device over TCP as a client or server.

In VM workflows, users add USB redirection devices in virt-manager or libvirt XML, configure QEMU `usb-redir` devices and SPICE channels, and select devices from remote-viewer once the SPICE connection is established. Filtering rules can block or auto-connect devices by USB class, vendor, product, and version.

### Why package nerds care

usbredir is package-nerd significant because it is the quiet glue behind a visible virtualization feature. Installing it satisfies build/runtime dependencies for QEMU/SPICE USB redirection and exposes the libraries that let packagers connect libusb, SPICE clients, and QEMU devices cleanly.

### Timeline

- 2011-02-03: Official Git history starts with initial usbredir import.
- 2011: Protocol version 0.2 demonstrated at FOSDEM.
- 2011-07-14: Protocol version 0.3 released as the first stable version.
- 2012: Protocol versions 0.4, 0.5, and 0.6 add filtering, 64-bit packet IDs, and buffered bulk input.
- 2014-05-19: Protocol version 0.7 released.
- 2025-01-27: Official tag usbredir-0.15.0 created.

### Related projects

- The official documentation ties usbredir to SPICE, QEMU, libvirt, virt-manager, remote-viewer, libusb, and UsbDk.

### Sources

- <https://gitlab.freedesktop.org/spice/usbredir>
- <https://gitlab.freedesktop.org/spice/usbredir/-/blob/main/docs/usb-redirection-protocol.md>
- <https://www.spice-space.org/usbredir.html>
- input source_facts.package-manager
- official git log and tags from https://gitlab.freedesktop.org/spice/usbredir.git


## Security Notes

library-like package without higher-risk signals.

- **Geiger risk:** green / low
- library-like package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** usbredir
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - libusbredirhost-dev - 0.15.0-1: normalized package name match | Debian stable package indexes: libusbredirhost-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | implementing the usb-host (*) side of a usbredir connection (development) | https://www.spice-space.org/
- Debian apt - libusbredirhost1t64 - 0.15.0-1: normalized package name match | Debian stable package indexes: libusbredirhost1t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Implementing the usb-host (*) side of a usbredir connection (runtime) | https://www.spice-space.org/
- Debian apt - libusbredirparser-dev - 0.15.0-1: normalized package name match | Debian stable package indexes: libusbredirparser-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Parser for the usbredir protocol (development) | https://www.spice-space.org/
- Debian apt - libusbredirparser1t64 - 0.15.0-1: normalized package name match | Debian stable package indexes: libusbredirparser1t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Parser for the usbredir protocol (runtime) | https://www.spice-space.org/
- Debian apt - usbredirect - 0.15.0-1: normalized package name match | Debian stable package indexes: usbredirect from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simple USB host TCP client | https://www.spice-space.org/
- Nix - usbredir: normalized package name match | nixpkgs package indexes: pkgs/by-name/us/usbredir/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - libusbredirhost-dev - 0.13.0-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libusbredirhost-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | implementing the usb-host (*) side of a usbredir connection (development) | https://www.spice-space.org/
- Ubuntu apt - libusbredirhost1t64 - 0.13.0-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libusbredirhost1t64 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Implementing the usb-host (*) side of a usbredir connection (runtime) | https://www.spice-space.org/
- Ubuntu apt - libusbredirparser-dev - 0.13.0-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libusbredirparser-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Parser for the usbredir protocol (development) | https://www.spice-space.org/
- Ubuntu apt - libusbredirparser1t64 - 0.13.0-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libusbredirparser1t64 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Parser for the usbredir protocol (runtime) | https://www.spice-space.org/
- Ubuntu apt - usbredirect - 0.13.0-2.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: usbredirect from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Simple USB host TCP client | https://www.spice-space.org/
- apk - libusbredirhost - 0.14.0-r0: normalized package name match | Alpine Linux edge package indexes: libusbredirhost from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | USB network redirection protocol libraries | https://www.spice-space.org/usbredir.html
- apk - libusbredirparser - 0.14.0-r0: normalized package name match | Alpine Linux edge package indexes: libusbredirparser from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | USB network redirection protocol libraries | https://www.spice-space.org/usbredir.html
- apk - usbredir - 0.14.0-r0: normalized package name match | Alpine Linux edge package indexes: usbredir from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | USB network redirection protocol libraries | https://www.spice-space.org/usbredir.html
- apk - usbredir-dev - 0.14.0-r0: normalized package name match | Alpine Linux edge package indexes: usbredir-dev from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | USB network redirection protocol libraries (development files) | https://www.spice-space.org/usbredir.html
- apk - usbredir-doc - 0.14.0-r0: normalized package name match | Alpine Linux edge package indexes: usbredir-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | USB network redirection protocol libraries (documentation) | https://www.spice-space.org/usbredir.html


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [glib](https://www.automicvault.com/pkg/brew/glib/) - Runtime dependency declared by Homebrew.
- [meson](https://www.automicvault.com/pkg/brew/meson/) - Build dependency declared by Homebrew.
- [ninja](https://www.automicvault.com/pkg/brew/ninja/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [spice-gtk](https://www.automicvault.com/pkg/brew/spice-gtk/) - Popular package that depends on this formula.
- [libcoap](https://www.automicvault.com/pkg/brew/libcoap/) - Shares av.db curated category or tags: cli, network-protocol, networking, protocols.
- [liblo](https://www.automicvault.com/pkg/brew/liblo/) - Shares av.db curated category or tags: cli, network-protocol, networking, protocols.
- [goat](https://www.automicvault.com/pkg/brew/goat/) - Shares av.db curated category or tags: cli, networking, protocols.
- [libbladerf](https://www.automicvault.com/pkg/brew/libbladerf/) - Shares av.db curated category or tags: cli, networking, usb.
- [packetry](https://www.automicvault.com/pkg/brew/packetry/) - Shares av.db curated category or tags: cli, networking, usb.
- [rinetd](https://www.automicvault.com/pkg/brew/rinetd/) - Shares av.db curated category or tags: cli, networking, redirection.
- [socket_vmnet](https://www.automicvault.com/pkg/brew/socket-vmnet/) - Shares av.db curated category or tags: cli, networking, virtualization.
- [activemq](https://www.automicvault.com/pkg/brew/activemq/) - Shares av.db curated category or tags: cli, networking.
- [libnice](https://www.automicvault.com/pkg/brew/libnice/) - Local package facts share a topical domain. Shared terms: cli, glib, networking.

## Combined YAML source

View the package source record on GitHub. [combined/usbredir.yml](https://github.com/automic-vault/db/blob/main/combined/usbredir.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
