Skip to content

Snakefoxu/SnakeUSBIP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🦊 SnakeUSBIP - Free USB/IP Client for Windows

🌐 Language / Idioma: English | Español

v2.0.3 | Download Latest | πŸ“– User Manual | 🌐 VPN Connection | πŸ–₯️ Windows Server

Share and connect USB devices over network (LAN/WiFi/Internet) easily. Transform any Linux device into a Virtual USB Hub accessible from Windows 10 and 11. Compatible with Raspberry Pi, Orange Pi, Banana Pi, OpenWRT routers, CrealityBox and any ARM/x86 board running Linux.

GitHub Downloads GitHub Stars License Platform

🎬 Video Tutorial

Video Tutorial

▢️ Watch full tutorial on YouTube (Spanish audio, visual guide)

πŸ†• What's New in v2.0.2

  • ️ Complete Rewrite - Migrated from PowerShell to .NET 9 (C# / WPF)
  • πŸ”” Hybrid Notifications - Custom non-intrusive popups (Window) + BalloonTips (Tray)
  • πŸ’Ύ Device Persistence - Remembers connected devices after restart
  • ⚑ Ultra-Fast - Native GUI with instant response times
  • ✏️ Rename Devices - Assign custom names to USB devices (saved permanently)
  • πŸ“š Updated Database - December 2025 usb.ids (+17,000 new devices)
  • πŸ› Bug Fixes - Fixed Auto-Update, Hardware ID conflicts, connection monitor logic

✨ Features

  • πŸ” Auto-Discovery - Scan for USB/IP servers on your local network
  • 🌐 Internet Connection - Connect via Tailscale/ZeroTier (NAT traversal)
  • πŸ”Œ Easy Connection - Connect/disconnect devices with one click
  • ⭐ Favorites - Save devices for quick reconnection
  • πŸ“‹ Activity Log - History of connections, scans, and errors
  • πŸ–₯️ Built-in SSH - Configure Raspberry Pi servers directly
  • πŸ“‹ Detailed Info - VID:PID and manufacturer for each device
  • 🎨 Modern GUI - Native WPF interface with dark/light themes
  • 🌐 Multi-language - English and Spanish
  • πŸ”„ Auto-update - Detects new versions from GitHub

πŸ“¦ Installation

Option 1: Portable

  1. Download from Releases:
    • Windows x64: SnakeUSBIP-v2.0.0-x64.zip
    • Windows ARM64: SnakeUSBIP-v2.0.0-arm64.zip (Surface Pro X, etc.)
  2. Extract the ZIP to any folder
  3. Run SnakeUSBIP.exe as Administrator
  4. Done!

Option 2: Installer (x64 only) (Recommended)

  1. Download SnakeUSBIP_Setup_v2.0.0.exe from Releases
  2. Run the installer as Administrator
  3. Follow the installation wizard

⚠️ ARM64 Users

ARM64 drivers are test-signed. See README_ARM64.md in the ZIP for instructions to enable Windows Test Mode.

πŸš€ Quick Start

  1. Scan - Click πŸ” Scan to find servers
  2. List - Click πŸ”„ List to see available devices
  3. Connect - Double-click a device or right-click β†’ Connect
  4. Disconnect - Right-click β†’ Disconnect

🌐 Internet Connection (VPN)

  1. Install Tailscale on Windows and your server
  2. Click 🌐 VPN to see peers with active USB/IP
  3. Select a remote server and connect

See docs/VPN_INTERNET_EN.md for complete guide.

🐧 USB/IP Server (Linux)

Works on any Linux device with USB ports:

Device Compatibility
πŸ“ Raspberry Pi (all models) βœ… Recommended
🍊 Orange Pi / Banana Pi βœ…
πŸ“¦ Arduino YΓΊn / similar βœ…
πŸ“‘ OpenWRT Routers βœ…
πŸ–¨οΈ CrealityBox (OpenWRT) βœ…
πŸ’» Any Linux PC βœ…
πŸ–₯️ x86/ARM Server βœ…

See docs/RASPBERRY_PI_SERVER_EN.md for complete instructions.

πŸ–₯️ USB/IP Server (Windows) - NEW!

SnakeUSBIP Server is a GUI wrapper for usbipd-win that makes sharing USB devices from Windows simple.

Features

  • πŸ”§ Auto-installation of usbipd-win driver
  • πŸ“€ One-click Share/Stop for USB devices
  • πŸ”’ Single UAC prompt at startup (no popups during use)
  • πŸ“› Descriptive device names via WMI enrichment
  • πŸ—‘οΈ Uninstall option to clean up drivers

Download

Download SnakeUSBIP-Server-v2.2.zip from Releases

Quick Setup

  1. Extract the ZIP
  2. Run SnakeUSBIP-Server.exe as Administrator
  3. Click Share on any USB device
  4. Use SnakeUSBIP client to connect from another PC

Quick setup (Debian/Ubuntu/Raspbian):

sudo apt update && sudo apt install -y linux-tools-generic hwdata
sudo modprobe usbip_host
sudo usbipd -D
sudo usbip list -l
sudo usbip bind -b 1-1.4  # Replace with your bus-id

OpenWRT:

opkg update && opkg install usbip-server kmod-usb-ohci
usbipd -D

🎯 What can I do with my device?

Have a spare Raspberry Pi, Orange Pi or CrealityBox? Turn them into a remote USB Hub!

Device Use Case
πŸ–¨οΈ CrealityBox Share your 3D printer over network. Connect from any PC without cables
πŸ“ Raspberry Pi Central USB hub: scanners, license dongles, card readers
🍊 Orange Pi Compact and affordable USB server for office
πŸ“‘ OpenWRT Router Share USB storage or printer from your router
πŸ” License Dongle Share USB software keys (AutoCAD, etc.) between PCs

πŸ“ Structure

SnakeUSBIP/
β”œβ”€β”€ SnakeUSBIP.exe      # Main application (.NET 9 WPF)
β”œβ”€β”€ usbipw.exe          # USB/IP client
β”œβ”€β”€ devnode.exe         # Device manager
β”œβ”€β”€ libusbip.dll        # USB/IP library
β”œβ”€β”€ drivers/            # USB/IP drivers (WHLK certified x64)
β”œβ”€β”€ usb.ids             # USB database (Dec 2025)
β”œβ”€β”€ CleanDrivers.ps1    # Driver cleanup script
└── Logo-SnakeFoxU-con-e.ico  # App icon

βš™οΈ Requirements

  • Windows 10/11
  • Administrator privileges
  • Local network with USB/IP server

πŸ“„ License

GPL v3 (GNU General Public License) - See LICENSE

πŸ™ Credits

This project wouldn't be possible without the work of:

Project Author Contribution
usbip-win2 Vadim Grn Microsoft-signed USB/IP drivers (WHLK certified). Core of the Windows client.
OctoWrt ihrapsa Original OpenWrt guide for CrealityBox. Inspiration for embedded device support.
OctoWrt Fork ShivaJiva Active OctoWrt maintenance. Updated releases for CrealityBox.
USB/IP Linux Kernel Original USB/IP protocol
SnakeUSBIP SnakeFoxu .NET WPF GUI, VPN integration, documentation

Special Thanks

  • 🦊 Vadim Grn - For the signed drivers that make USB/IP possible on Windows without test mode
  • πŸ™ OctoWrt Community - For showing the CrealityBox can be much more than a paperweight
  • 🐧 Linux USB/IP Team - For creating the protocol that makes all this possible