USBMap

USBMap

by CorpNewt
Utilities

macOS-only USB mapping tool for creating custom USB port maps on Hackintosh

Download GitHub
Advertisement
Advertisement (336×280)

USBMap

Note

This is a utility tool, NOT a kext. It does not need to be installed in your EFI.

USBMap is a Python script for mapping USB ports in macOS and creating a custom injector kext. It uses a “sliding window” approach to work within macOS’s 15-port limit.

Overview

macOS limits each USB controller to 15 ports. USBMap helps you discover which ports your system has, select the ones you need, and generate a custom USBPorts.kext that maps only those ports.

Features

  • Port Discovery: Discover all USB ports on your system
  • Sliding Window: Uses a sliding window approach to work within the 15-port limit
  • Custom Kext Generation: Generate a USBPorts.kext tailored to your hardware
  • Controller Support: Supports XHCI, EHCI, OHCI, and UHCI controllers
  • No USBInjectAll Dependency: Works without USBInjectAll.kext installed

Installation

  1. Download from GitHub
  2. Extract the ZIP file
  3. Run USBMap.command (macOS only)

Requirements

  • macOS (this tool is macOS-only)
  • Python 3.6 or later

Usage

  1. Launch USBMap
  2. Select Discover Ports to list all USB ports
  3. Plug USB devices into each port to identify them
  4. Select the ports you want to keep (maximum 15 per controller)
  5. Generate a USBPorts.kext
  6. Copy the generated kext to EFI/OC/Kexts/ and update your config.plist

USBMap vs USBToolBox

  • USBMap: macOS-only, handles the 15-port limit with a sliding window approach. Better if you must map from macOS.
  • USBToolBox: Supports Windows (recommended), has companion port detection and port type guessing. Better if you can map from Windows.

For most users, USBToolBox from Windows is the recommended approach.

FAQ

Can I use USBMap on Windows?

No, USBMap is macOS-only. For Windows, use USBToolBox instead.

What’s the 15-port limit?

macOS limits each USB controller to 15 ports. This includes both USB 2.0 and USB 3.0 ports. A custom USB map ensures you stay within this limit while enabling the ports you need.

Resources