HomeKit QR code generator
Enter the 8-digit HomeKit setup code, the accessory category, how it pairs and its 4-character setup ID, and the tool builds the X-HM:// QR code that Apple's Home app scans. Download it as PNG or SVG, or print it as a label.
Use the ID your accessory advertises. A made-up ID gives a valid code the Home app cannot match to the device.
Enter a setup code to see the QR code.
Your setup code is turned into a QR code on this page. Nothing is uploaded or sent anywhere.
How to use it
- Type the 8-digit setup code from the device, its box or its manual. Dashes are optional.
- Choose the accessory category and how it pairs. IP (Wi-Fi or Ethernet) is right for Homebridge, HAP-NodeJS and most ESP accessories.
- Enter the 4-character setup ID your accessory uses. The Home app scans the code, then looks for an accessory advertising that ID, so it has to match.
- Download the PNG or SVG, or press Print label for a small sticker sized sheet.
- In the Home app choose Add Accessory and scan the code to check it.
What is inside a HomeKit QR code
A HomeKit setup QR code holds a short text starting with X-HM://. The next 9 characters are a base 36 number that packs the setup code, the accessory category and the pairing flags. The last 4 characters are the setup ID, which the accessory also advertises so the Home app knows the code belongs to it.
- Setup code: 8 digits, usually written as XXX-XX-XXX.
- Category: the type of accessory, such as lightbulb, door lock or bridge.
- Flags: which transports can pair, IP, Bluetooth LE or NFC.
- Setup ID: 4 letters or digits that must match what the accessory broadcasts.
Questions
Where do I find the setup ID?
Homebridge keeps it as setupID in the AccessoryInfo file in its persist folder, HAP-NodeJS takes it as the setupID publish option, and ESP HomeKit firmware sets it as setupId in the firmware config. A store-bought accessory with a lost sticker does not show its setup ID anywhere, so for that one skip the QR code and type the 8-digit code in the Home app under More options.
Which category should I pick?
Use Other for a plain accessory or Bridge for a Homebridge bridge. The category sets the icon the Home app shows while it pairs, so a close match pairs the same way.
Can I scan the label for an accessory that is already paired?
No. A HomeKit accessory accepts a new pairing only while it is unpaired. Remove it from the Home app or reset it first, then scan the label.
Why does the tool refuse codes like 12345678?
HomeKit bans a list of easy codes, including repeated digits, 12345678 and 87654321. A device using one of them will not pair, so pick a different code in the accessory config.
What size should I print the label?
About 2 cm (0.8 in) per side scans fine from close range. Print on white, keep the black and white contrast, and leave the blank border around the code.
Running Homebridge on a Pi or a home server?
Multimeter is a Mac menu bar app that turns numbers into small live meters. Its homelab recipes put a Home Assistant sensor, Pi-hole's blocked count or your running Docker containers in the menu bar.
Related
- Matter vs HomeKit checker
- How do I control my HomeKit accessories from a Mac?
- How do I control Homebridge accessories from my Mac?
Updated 2026-11-17