Turn your USB printer into a network printer – and switch it back, any time, as if it were plugged straight into your PC.
Got a printer that only does USB and want the whole household to print on it? Plug it into a Raspberry Pi and Printer Switch turns the Pi into a print server for you: it installs and sets up everything, so the printer is available on the network to every computer and phone.
The main part comes after that. A network printer loses what only works over USB: the manufacturer's software for toner levels, cleaning, maintenance or firmware updates cannot see it over the network. Printer Switch fixes that with one click: the printer starts behaving, for your PC, as if it were plugged into it with a USB cable. When you are done, one more click gives it back to the network. The cable stays at the Raspberry Pi – it all happens over the network.
- One button in the notification area. The icon shows the state – green: on the network, orange: attached to this PC, red: another computer has it – and updates by itself.
- Never leaves the printer stuck. If anything fails half way, the printer goes straight back to CUPS. Exiting while the printer is attached asks first.
- Setup wizard that finds the print server on the network, sets up SSH key login and installs the USB/IP driver on the PC.
- Turns a fresh Raspberry Pi into a print server – CUPS, the printer driver and network sharing – or leaves your existing server alone and installs only a tiny helper.
- Raspberry Pi tuning for a stable 24/7 print server, each item optional and reversible.
- Settings like Windows 11 Settings – connection, printer, driver, language, autostart; the wizard runs on first start and stays one click away.
- Updates itself from GitHub Releases – checks after every start and then once a day, and installs only an installer signed with the author's release key, which never leaves the author's PC: taking over the GitHub account is not enough to push a fake update. Installs silently and starts again. Can be turned off.
- Native Windows 11 look, light and dark mode.
- English, Čeština, Deutsch, Slovenčina, Polski – switch at any time.
Windows PC Print server (Raspberry Pi …)
┌──────────────────────┐ SSH (port 22) ┌──────────────────────────────┐
│ Printer Switch │ ═════════════════► │ printswitch share │
│ usbip-win2 driver │ USB/IP inside │ stops CUPS, exports the │
│ 127.0.0.1:3240 ────┼── the SSH tunnel ─►│ printer with usbipd │
└──────────────────────┘ └──────────────┬───────────────┘
│ USB
printer
- Over SSH the app asks the server to stop CUPS and export the printer with
usbipd. - It opens an SSH tunnel and attaches the device through it with usbip-win2. Windows sees a USB printer.
- Giving it back detaches the device, closes the tunnel and starts CUPS again.
USB/IP has no authentication or encryption of its own, so it never travels over the network directly: while the printer is lent, the server drops port 3240 on every interface except loopback, and all traffic runs inside SSH.
- …share it with CUPS (or Windows printer sharing)? That is exactly what Printer Switch sets up, and for printing it is all you need. But the manufacturer's tools (toner, cleaning, firmware), scanning on many multifunction printers and some older drivers want a USB connection – that is the gap the switch fills.
- …use VirtualHere, FlexiHub or USB Network Gate? They share any USB device and are mature, but closed source and paid beyond a basic tier. Printer Switch is free (GPL), does one thing – a printer – and does all the setup for you, including the print server.
- …run usbip by hand? That is what happens underneath. By hand it means SSH, stopping
CUPS,
usbip bind, a tunnel,usbip attach– and remembering to undo it all, or nobody else can print. Printer Switch does it in one click and always gives the printer back.
You need: Windows 10 (20H1) or 11, 64-bit · a Raspberry Pi or other Debian-based Linux box with the printer on USB · SSH access to it (a password once is enough).
-
Download
PrinterSwitch-Setup-x.y.z.exefrom Releases and run it. It installs into Program Files and asks for administrator rights once. The installer is not code-signed yet, so SmartScreen may warn: More info → Run anyway. -
The setup wizard walks you through it:
-
Click the icon next to the clock and press Attach to this PC.
Learned the hard way on a Raspberry Pi Zero W that had to print reliably day and night.
Nothing is applied unless you tick it and press Apply; items already in place are detected
and left alone; everything can be undone with sudo printswitch unoptimize <id>.
| Item | What it does |
|---|---|
journal |
keeps the system log across restarts (max 64 MB), so you can see why the Pi froze |
wifi-powersave |
turns off Wi-Fi power saving – the usual reason small Pis drop off the network |
watchdog |
hardware watchdog: a frozen Pi restarts itself within a minute |
updates |
daily security updates, never with an unannounced restart |
auto-restart |
Sunday 4:05 restart window – only if an update needs it, nothing is printing and the printer is not lent |
services * |
turns off Bluetooth, colour management, modem manager and cloud-init |
audio * |
turns off sound |
* offered only when you confirm the Pi is used for nothing but printing.
| What | Where |
|---|---|
helper script (source: server/printswitch) |
/usr/local/sbin/printswitch |
| sudo rule allowing only that script without a password | /etc/sudoers.d/printswitch |
usbip package and its kernel modules |
apt, /etc/modules-load.d/usbip.conf |
| the app's public key (only if you used a password) | ~/.ssh/authorized_keys |
| full setup only: CUPS, Avahi, the printer driver, the shared queue | apt, CUPS |
tuning only: small drop-in files named *printswitch* |
/etc/systemd, /etc/NetworkManager/conf.d, /etc/apt/apt.conf.d |
Remove the helper with sudo rm /usr/local/sbin/printswitch /etc/sudoers.d/printswitch.
While the printer is lent, /run/printserver-usbip.busid exists – handy for monitoring to tell
"lent on purpose" from "CUPS crashed".
| Problem | Fix |
|---|---|
| "The printer is not visible on the server" | Switch it on, check the cable. printswitch devices on the server lists what it sees. |
| Attaching fails on the PC | Restart Windows after installing usbip-win2; USBip 3.X Emulated Host Controller must be in Device Manager. |
| The printer stayed lent after a crash | Give back to the network in the app, or sudo printswitch unshare on the server. |
| Network printing does not come back | sudo systemctl restart cups; sometimes the USB cable needs replugging. |
| Other subnets / VLANs cannot print | CUPS sharing allows the local subnet only; add your subnet with Allow in /etc/cups/cupsd.conf. |
Log: %LOCALAPPDATA%\PrinterSwitch\log.txt (tray menu → Show log) ·
settings: %APPDATA%\PrinterSwitch\settings.json · long server jobs: /var/log/printswitch-job.log.
.NET 10 SDK and
Inno Setup 6 (winget install JRSoftware.InnoSetup):
.\build.ps1 -Version 1.0.0 # -> dist\PrinterSwitch-Setup-1.0.0.exeC# / WPF with the built-in Fluent theme; SSH runs in-process through SSH.NET, so neither
ssh.exe nor PowerShell is needed. GitHub Actions only checks that every push builds;
releases are built, signed and published from the author's PC with
tools\release.ps1 -Version x.y.z (key: tools\release-key.ps1). Translations live in
src/PrinterSwitch/Core/L.cs – new languages are welcome.
Printer Switch is © 2026 typekborispav and free software under the GNU General Public License v3.0 or later: you may use, share and modify it, and anything built from it must stay open under the same licence and keep the credits.
It stands on the shoulders of others – see THIRD-PARTY-NOTICES.md for every component and its licence: .NET (MIT), SSH.NET (MIT), Bouncy Castle (MIT), usbip-win2 (GPL-3.0, downloaded separately), Linux USB/IP, CUPS and Inno Setup.
Raspberry Pi is a trademark of Raspberry Pi Ltd. This project is independent and not affiliated with Raspberry Pi Ltd, Microsoft or any printer manufacturer.



