{"id":13561782,"url":"https://github.com/dorssel/usbipd-win","last_synced_at":"2025-05-13T21:03:45.368Z","repository":{"id":37860946,"uuid":"305202189","full_name":"dorssel/usbipd-win","owner":"dorssel","description":"Windows software for sharing locally connected USB devices to other machines, including Hyper-V guests and WSL 2.","archived":false,"fork":false,"pushed_at":"2025-05-08T15:37:24.000Z","size":6648,"stargazers_count":4378,"open_issues_count":62,"forks_count":261,"subscribers_count":50,"default_branch":"master","last_synced_at":"2025-05-08T16:44:55.437Z","etag":null,"topics":["hyper-v","usb","usbip","usbip-win","usbipd","windows","wsl","wsl2"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dorssel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"dorssel"}},"created_at":"2020-10-18T21:44:11.000Z","updated_at":"2025-05-08T00:30:10.000Z","dependencies_parsed_at":"2024-01-10T09:47:16.377Z","dependency_job_id":"0b88725f-ebbc-4392-99b1-999b3d08019c","html_url":"https://github.com/dorssel/usbipd-win","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorssel%2Fusbipd-win","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorssel%2Fusbipd-win/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorssel%2Fusbipd-win/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorssel%2Fusbipd-win/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dorssel","download_url":"https://codeload.github.com/dorssel/usbipd-win/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254027910,"owners_count":22002133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hyper-v","usb","usbip","usbip-win","usbipd","windows","wsl","wsl2"],"created_at":"2024-08-01T13:01:01.069Z","updated_at":"2025-05-13T21:03:45.324Z","avatar_url":"https://github.com/dorssel.png","language":"C#","funding_links":["https://github.com/sponsors/dorssel"],"categories":["C# #","C\\#","C#","Developer Tools","Tool"],"sub_categories":["Command Line Tools","Windows Tool"],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2020 Frans van Dorsselaer\n\nSPDX-License-Identifier: GPL-3.0-only\n--\u003e\n\n# usbipd-win\n\n[![Build](https://github.com/dorssel/usbipd-win/actions/workflows/build-installer.yml/badge.svg?branch=master)](https://github.com/dorssel/usbipd-win/actions/workflows/build-installer.yml?query=branch%3Amaster)\n[![CodeQL](https://github.com/dorssel/usbipd-win/actions/workflows/codeql-analysis.yml/badge.svg?branch=master)](https://github.com/dorssel/usbipd-win/actions/workflows/codeql-analysis.yml?query=workflow%3ACodeQL+branch%3Amaster)\n[![MegaLinter](https://github.com/dorssel/usbipd-win/actions/workflows/lint.yml/badge.svg?branch=master)](https://github.com/dorssel/usbipd-win/actions/workflows/lint.yml?query=workflow%3ALint+branch%3Amaster)\n[![REUSE status](https://api.reuse.software/badge/github.com/dorssel/usbipd-win)](https://api.reuse.software/info/github.com/dorssel/usbipd-win)\n[![Codecov](https://codecov.io/gh/dorssel/usbipd-win/branch/master/graph/badge.svg?token=L0QI0AZRJI)](https://codecov.io/gh/dorssel/usbipd-win)\n[![GitHub all releases](https://img.shields.io/github/downloads/dorssel/usbipd-win/total?logo=github)](https://github.com/dorssel/usbipd-win/releases)\n\nWindows software for sharing locally connected USB devices to other machines, including Hyper-V guests and WSL 2.\n\n## How to install\n\nThis software requires\nMicrosoft Windows 10 (x64 or ARM64) / Microsoft Windows Server 2019, version 1809 or newer;\nit does not depend on any other software.\n\nRun the installer (.msi) from the [latest release](https://github.com/dorssel/usbipd-win/releases/latest)\non the Windows machine where your USB device is connected.\n\nAlternatively, use the Windows Package Manager:\n\n```powershell\nwinget install usbipd\n```\n\nThis will install:\n\n- A service called `usbipd` (display name: USBIP Device Host).\\\n  You can check the status of this service using the Services app from Windows.\n- A command line tool `usbipd`.\\\n  The location of this tool will be added to the `PATH` environment variable.\n- A firewall rule called `usbipd` to allow all local subnets to connect to the service.\\\n  You can modify this firewall rule to fine tune access control.\n\n\u003e [!NOTE]\n\u003e If you are using a third-party firewall, you may have to reconfigure it to allow\n\u003e incoming connections on TCP port 3240.\n\n## How to use\n\n### Share Devices\n\nBy default devices are not shared with USBIP clients.\nTo lookup and share devices, run the following commands with administrator privileges:\n\n```powershell\nusbipd --help\nusbipd list\nusbipd bind --busid=\u003cBUSID\u003e\n```\n\nSharing a device is persistent; it survives reboots.\n\n\u003e [!TIP]\n\u003e See the [wiki](https://github.com/dorssel/usbipd-win/wiki/Tested-Devices) for a list of tested devices.\n\n### Connecting Devices\n\nAttaching devices to a client is non-persistent. You will have to re-attach after a reboot,\nor when the device resets or is physically unplugged/replugged.\n\n#### Non-WSL 2\n\nFrom another (possibly virtual) machine running Linux, use the `usbip` client-side tool:\n\n```bash\nusbip list --remote=\u003cHOST\u003e\nsudo usbip attach --remote=\u003cHOST\u003e --busid=\u003cBUSID\u003e\n```\n\n\u003e [!NOTE]\n\u003e Client-side tooling exists for other operating systems such as Microsoft Windows, but not as part of this project.\n\n#### WSL 2\n\nYou can attach the device from within Windows with the following command, which does not require administrator privileges:\n\n```powershell\nusbipd attach --wsl --busid=\u003cBUSID\u003e\n```\n\n\u003e [!TIP]\n\u003e See the [wiki](https://github.com/dorssel/usbipd-win/wiki/WSL-support) on how to add drivers\n\u003e for USB devices that are not supported by the default WSL 2 kernel.\n\n### GUI\n\nSee the [wiki](https://github.com/dorssel/usbipd-win/wiki/Graphical-User-Interfaces)\nfor a list of GUI and IDE integration tools in case you prefer that over a CLI.\n\n## How to remove\n\nUninstall via Add/Remove Programs or via Settings/Apps.\n\nAlternatively, use the Windows Package Manager:\n\n```powershell\nwinget uninstall usbipd\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdorssel%2Fusbipd-win","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdorssel%2Fusbipd-win","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdorssel%2Fusbipd-win/lists"}