iKontroller
Wireless Game Controller for Mac
Getting Started
iKontroller transforms your iPhone or iPad into a wireless game controller for your Mac. Follow these steps to get started:
- Install both apps: Download iKontroller on your iOS device (iPhone or iPad) and iKontroller Desktop on your Mac from the App Store
- Grant permissions: On Mac, grant Accessibility permissions when prompted
- Connect devices: Open both apps and ensure they're on the same Wi-Fi network or connected via USB-C/Lightning cable
- Pair: Follow the on-screen pairing instructions and enter the 6-digit code
- Start controlling: You're ready to go!
System Requirements
📱 iOS
- iOS 16.0 or later
- iPhone or iPad
- Wi-Fi or USB cable
- Local network permission
💻 macOS
- macOS 14.0 or later
- Apple Silicon or Intel
- Accessibility permissions
- Local network permission
Frequently Asked Questions
Q: How do I grant Accessibility permissions on Mac?
A: Go to System Settings → Privacy & Security → Accessibility, then enable iKontroller in the list.
Q: My devices won't connect. What should I do?
A: Try these steps:
- Ensure both devices are on the same Wi-Fi network
- Restart both apps
- Check that your firewall isn't blocking the connection
- Try USB cable connection as an alternative
Q: The keyboard keys are "stuck" or not releasing
A: iKontroller has automatic key unsticking detection. If a key gets stuck:
- Disconnect and reconnect your iOS device
- Press the stuck key on your physical keyboard
- Press or use the button/joystick that caused the stuck key(s) and it should get released
- The app automatically detects and fixes double-presses
Q: Can I use multiple iOS devices with one Mac?
A: Yes! You can pair multiple iOS devices to a single Mac. Each device maintains its own custom layouts and mappings.
Q: How do I adjust touchpad sensitivity?
A: On Mac, go to Settings → General and adjust the "Relative Sensitivity" slider.
Q: How do I adjust scrolling sensitivity?
A: On Mac, go to Settings → General and adjust the "Scroll Sensitivity" slider.
Q: Does this work with games in full-screen mode?
A: Yes! iKontroller is designed to work seamlessly with full-screen/minimized/windowed apps and games on your Mac.
Q: What's the difference between relative and absolute touchpad modes?
A:
- Relative mode: Used when gaming to move the in-game camera around (First person shooter, etc.). Moves cursor relative to current position, automatically recenters. The relative mode is depicted using a red eye on the top left corner of your touchpad.
- Absolute mode: Used for direct cursor positioning aka moving your visual cursor around. Touch maps to exact screen location. The absolute mode is depicted using a blue cursor on the top left corner of your touchpad.
Q: How do I create custom layouts?
A: On iOS, tap the "Layouts" button, then "+" to create a new layout. Add controls from the palette and position/resize them as needed. Map the buttons and joysticks to keyboard keys
Q: Is my data being sent to any servers?
A: No. All communication is direct between your iOS device and Mac. We don't collect, store, or transmit any data to external servers. See our Privacy Policy for details.
Troubleshooting
Connection Issues
- Devices not discovering each other: Check Wi-Fi settings, ensure Local Network permissions are granted on iOS and Mac
- Connection drops frequently: Try switching to USB cable connection, or check for Wi-Fi issues/interference
- High latency: Reduce distance between devices, close bandwidth-heavy apps, use 5GHz Wi-Fi, or switch to USB cable connection
Permission Issues
- Mac Accessibility permission: System Settings → Privacy & Security → Accessibility → Enable iKontroller
- iOS Local Network permission: Settings → Privacy and Security → Local Network → Enable iKontroller
- Mac Local Network permission: Settings → Privacy and Security → Local Network → Enable iKontroller
Mapping Issues
- Mappings not saving: Ensure you've tapped "Done" or closed the mapping popup only after setting the keys
- Buttons/Joysticks not responding: Allow the mapping version to get synchronized by disconnecting and reconnecting
Contact Support
Need more help? Reach out to us: