usb-remote#
Client-server software to share USB devices over the network.
Source |
|
|---|---|
PyPI |
|
Docker |
|
Documentation |
|
Releases |
Overview#
usb-remote allows USB devices to be easily discovered and shared over a network using the USB/IP USB-over-Ethernet service.
A usb-remote server runs on a machine with physical USB devices attached and shares its devices to clients. Clients can connect to multiple servers to access and control their USB devices as if they were locally connected.
Comparison to Digi’s AnyWhereUSB#
usb-remote is a FOSS alternative to commercial USB-over-Ethernet solutions like Digi’s AnyWhereUSB.
Advantages of Digi’s AnyWhereUSB:
Commercial product with support and warranty
Dedicated hardware servers for USB device sharing
Excellent security features controlling access to USB devices
Advantages of usb-remote:
Good support for UVC isochronous Webcams that do not work with AnyWhereUSB
Very simple to setup and use in trusted network environments
Free and open source software (FOSS)
The server runs on standard hardware such as a $55 Raspberry Pi
Installation#
See the Server Setup and Client Setup guides for installation instructions.
Example Client Commands#
# List devices on all configured servers
usb-remote list
# List devices on a specific server
usb-remote list --host raspberrypi1
# Attach a device my description substring
# (scans all servers, fails on multiple matches)
usb-remote attach --desc "Camera"
# Attach first matching device across servers
usb-remote attach --desc "Camera" --first
# Attach a device based on serial number - recommended to guarantee unique match
usb-remote attach --serial=1272D8DF
# Detach a device
usb-remote detach --serial=1272D8DF
# Find devices on the 1-4 bus of a specific server, using a glob pattern
usb-remote list --host raspberrypi1 --bus '1-4-*'
Search Arguments:
--desc TEXT: substring or glob pattern to match device description--serial TEXT: glob pattern to match device serial number--bus TEXT: glob pattern to match USB bus ID (e.g.1-4.3)--host TEXT: search a single server by hostname or IP address
Architecture#
See the Architecture Reference for full details.
How the documentation is structured#
Documentation is split into four categories, also accessible from links in the top bar.