devices

Register and manage test devices (UDIDs) for development and ad-hoc builds.

Why Register Devices?

To install development or ad-hoc builds on physical iOS devices, you must: 1. Register the device's UDID with Apple 2. Include the device in your provisioning profile

This is required by Apple for all non-App Store distributions.

Commands Overview

devices

List all registered test devices.

Usage

mysigner devices [options]

Options

Example

$ mysigner devices

📱 Devices

  ✓ John's iPhone 15 Pro (ID: 1)
    UDID: 00008030-001A1B2C3D4E567F
    Platform: IOS | Class: IPHONE
    Status: ENABLED

  ✓ Test iPad (ID: 2)
    UDID: da83bb40dba39e35d258988d856508798db7afba
    Platform: IOS | Class: IPAD
    Status: ENABLED

Page 1 of 1 (2 total)

device detect

Auto-detect iOS devices connected to your Mac via USB.

Usage

mysigner device detect

What It Does

1. Scans for connected iOS devices
2. Shows device names and UDIDs
3. Offers to register them interactively

Example

$ mysigner device detect

🔍 Detecting connected iOS devices...

Found 2 device(s):

  1. John's iPhone
     UDID: 00008030-001A1B2C3D4E567F

  2. Test iPad
     UDID: da83bb40dba39e35d258988d856508798db7afba

Would you like to register a device? (Enter number, or 'n' to skip)
> 1

Enter a name for this device (or press Enter to use 'John's iPhone'):
> John's iPhone 15 Pro

📱 Registering 'John's iPhone 15 Pro'...

✓ Device registered successfully!
  Name:     John's iPhone 15 Pro
  UDID:     00008030-001A1B2C3D4E567F
  Platform: IOS

Tips for Detection

If no devices are detected: - Make sure the device is connected via USB - Unlock the device - Trust the computer on the device when prompted - For better detection, install libimobiledevice: brew install libimobiledevice

device add

Manually register a device by name and UDID.

Usage

mysigner device add NAME UDID [options]

Arguments

Options

Examples

# Register an iPhone
mysigner device add "My iPhone 15" 00008030-001A1B2C3D4E567F

# Register an iPad
mysigner device add "Test iPad" da83bb40dba39e35d258988d856508798db7afba

# Register a Mac for Mac Catalyst apps
mysigner device add "MacBook Pro" ABC123DEF456... --platform MAC_OS

Example Output

$ mysigner device add "My iPhone 15" 00008030-001A1B2C3D4E567F

📱 Registering device...

✓ Device registered successfully!

Details:
  Name:     My iPhone 15
  UDID:     00008030-001A1B2C3D4E567F
  Platform: IOS
  Status:   ENABLED

device update

Rename an existing device.

Usage

mysigner device update ID NEW_NAME

Arguments

Example

$ mysigner device update 1 "John's iPhone 15 Pro"

📱 Updating device...

Current name: John's iPhone
New name:     John's iPhone 15 Pro

✓ Device updated successfully!

Details:
  Name:     John's iPhone 15 Pro
  UDID:     00008030-001A1B2C3D4E567F
  Platform: IOS

How to Get a Device UDID

Method 1: Auto-detect (Recommended)

mysigner device detect

Connect your device via USB and run this command. It will find all connected devices and show their UDIDs.

Method 2: Via Finder (macOS)

1. Connect your iPhone/iPad to your Mac
2. Open Finder and select your device in the sidebar
3. Click on the device info (below the device name) to cycle through info
4. When UDID is shown, right-click → Copy UDID

Method 3: Via Xcode

1. Connect your device
2. Open Xcode → Window → Devices and Simulators
3. Select your device
4. The UDID is shown as "Identifier"

UDID Formats

Limits

• You can register up to 100 devices per year per Apple Developer account
• Devices count toward the limit even if disabled
• The count resets on your annual membership renewal date

After Registering

After registering new devices, you may need to:

1. Regenerate provisioning profiles to include the new device
2. Run mysigner sync ios to update your local cache
3. Rebuild your app with the updated profile

For development builds: bash mysigner build --type development

Related Commands

• profiles - Manage provisioning profiles
• doctor - Check setup and auto-fix issues
• sync - Sync resources from Apple