Making USB mapping simple(r)
The USBToolBox tool is a USB mapping tool supporting Windows and macOS. It allows for building a custom injector kext from Windows and macOS.
Windows 10 or 11 64-bit are recommended for the full feature set (companion port binding, port type guessing.). Windows 8 may work, Windows 7 and below will very likely crash. 32-bit is not supported, macOS needs 64-bit anyway.
Simply download the latest Windows.exe
from releases. If Windows Defender/other antivirus complains, you can either whitelist the download or use Windows.zip
, which doesn't have a self extractor (which is what most antiviruses seem to complain about).
Yes this works lol. Some device names may not be as descriptive but if you really don't want to install Windows, you can create a Windows PE USB and hit Shift + F10 to open cmd
, then run the program.
macOS is not recommended for several reasons. You won't have features like guessing port types (as there simply isn't enough info for this) as well as binding companion ports (again, no info). However, there's also port limits to deal with, and in macOS 11.3, XhciPortLimit
is broken, resulting in a lot more hoops to go through. If you are forced to use macOS, you should probably use USBMap instead, as it has code to handle the port limit.
If you still want to use USBToolBox on macOS, download macOS.zip
from releases.
This is gonna be a very basic guide for now. A fully-fleshed guide will be released in the future.
EFI/OC/Kexts
folder, and make sure to update your config.plist
.
UTBDefault.kext
, if you have it.See the issues tab for known issues.
Q: Why is some information missing?
A: Make sure you have drivers installed for all your devices. On Windows, some information is missing if you don't have drivers installed, leading USBToolBox to report them as unknown.
Q: How do I report a bug?
A: Please go to the new issue page, click on "Bug report", and read through the steps before filling them out. Please ensure that you respond to my inquiries as there's no other way I can fix bugs.
@CorpNewt for USBMap. This project was heavily inspired by USBMap (and some functions are from USBMap).
My testing team (you know who you are) for testing