iKontroller Desktop for MacOS

Setup Guide

1. Install iKontroller Desktop on your Mac
2. Launch the app and enter your username
3. Grant Local Network permission: System settings → Privacy and Security → Local Network → Enable iKontroller Desktop
4. Grant Accessibility permission: System Settings → Privacy & Security → Accessibility → Enable iKontroller Desktop
5. Your Mac will start advertising itself and browse for iOS devices

Granting Accessibility Permissions

iKontroller Desktop requires Accessibility permissions to simulate keyboard and mouse input.

How to Grant this permission:

1. Open System Settings (or System Preferences on older macOS)
2. Navigate to Privacy & Security
3. Click on Accessibility
4. Click the + button (you may need to unlock with your password)
5. Find and enable iKontroller Desktop
6. Your Mac is now able to simulate keyboard and mouse input!

Device Pairing

Pairing a new iPhone or iPad

1. Ensure your Mac and iPhone/iPad are on the same Wi-Fi network, Cellular network or connected via USB-C/Lightning cable.
2. On your Mac, go to the Device Pairing tab
3. On your iPhone/iPad, select your Mac's username from the discovered devices
4. Accept the pairing request on your Mac. A 6-digit code will then appear
5. Enter this code on your iPhone/iPad
6. The devices are now paired!

Managing Paired Devices

• Forget: Remove a device as paired and delete all its mappings and data
• Block: Remove a device as paired, delete all its mappings and data and prevent the device from pairing again. A blocked device cannot send you any pairing requests and data
• Unblock: Settings → Blocked Devices → Unblock

Settings & Customization

Adjusting Sensitivity

Navigate to Settings → General:

• Relative Sensitivity: Controls in-game camera movement speed
• Scroll Sensitivity: Controls vertical and horizontal scrolling speed

Changing Username

1. Navigate to Settings → General
2. Click the pencil icon next to your username
3. Enter your new username
4. Click Save (iKontroller validates and saves the username)

Active Keys Visualization

iKontroller Desktop shows floating visual feedback of active keys on your "Main" screen. This helps with:

• Verifying key press(es) during use
• Streaming and recording
• Debugging custom mappings

Keys appear as they're pressed and fade out when released.

Troubleshooting Mac Issues

Keys Not Working/Stuck Keys

• Verify Accessibility permissions are granted
• Disconnect and reconnect your iPhone/iPad
• iKontroller Desktop has automatic stuck key detection and correction; Press or use the control(s) that caused the stuck key(s) again and release(s) will be sent
• Press the stuck key on your physical keyboard to release it

Mouse Cursor Behavior Issues

• Adjust Relative Sensitivity in Settings
• Switch between Relative and Absolute mode on your iPhone/iPad

Connection Drops After Network Change

• iKontroller automatically detects network changes
• Both apps will attempt to reconnect
• If reconnection fails, manually disconnect and reconnect on your iPhone/iPad

Firewall Blocking Connections

If using a firewall:

1. Open System Settings → Network → Firewall
2. Click Options
3. Ensure iKontroller is allowed to receive incoming connections
4. Add ports 8888, 8889, 8896, 8897, 8898, 8899 if using custom firewall rules