USB Map

USB Map provides a map of your USB hardware for passthrough planning: each USB controller with its IOMMU group and whether it is safe to pass through to a VM…

  • Infrastructure
  • Plugins
  • Tools & Utilities
USB Map provides a map of your USB hardware for passthrough planning: each USB controller with its IOMMU group and whether it is safe to pass through to a VM (and which one holds the Unraid boot device), the USB 2 / USB 3 port pairs behind each physical connector, hubs, and devices with their link speed against the port maximum. Name your ports with Identify mode (plug something in, the port lights up). Thunderbolt / USB4 controllers are linked to their USB side. Read-only. Tools → USB Map.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

40/100 Fair

Maintained
72last commit 21 days ago
Popular
00 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
0
Open issues
0
Last commit
2026-10-30
Latest release
v2026.10.30aa
Activity
rising

Checked 8 days ago - source: GitHub (ibigsnet/UsbMap)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Install and access Install the USB Map plugin from Unraid Community Apps, then open it in the Unraid web UI under Tools → USB Map. It is read-only and makes no changes to the system. source
  • Getting started Install the USB Map plugin from Unraid Community Applications, then open its read-only interface from the Unraid web UI: Tools → USB Map. source

Fetched 5 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Where in Unraid do I find USB Map?

Open it from the Unraid interface under Tools, then USB Map.

Does USB Map modify any system settings while it runs?

No, it is read-only and changes nothing on the system.

Can USB Map help me choose a USB controller for VM passthrough?

Yes, it identifies xHCI controllers, IOMMU groups, and maps the PCI BDF to the USB bus and tree to help plan VFIO passthrough.

Does USB Map show what USB speed a port is expected to support?

Yes, it identifies the expected USB standard and maximum speeds for the mapped hardware.

Answers sourced from github.com

Community

Collected 8 days ago - public community threads