Skip to main content

Getting Started

Get up and running with Ultragrip in under 5 minutes.

1

Download Ultragrip

Get the latest version for your operating system. Available for macOS, Windows, and Linux.

Download Now
2

Install & Grant Permissions

Run the installer, then grant the permissions Ultragrip needs to send input and detect your active window.

  • macOS: System Settings > Privacy & Security > Accessibility (required to send keyboard and mouse input)
  • macOS: System Settings > Privacy & Security > Screen Recording (optional, lets Ultragrip read window titles for context-aware dictation; restart the app after granting)
  • Windows: No special permissions needed; some apps may require running as administrator
  • Linux: May require udev rules for controller access; works with X11 (Wayland support is planned)
3

Connect Controller

Plug in your gamepad via USB or pair via Bluetooth. Ultragrip auto-detects most standard controllers (PlayStation, Xbox, 8BitDo).

  • PlayStation 4/5: Hold PS + Share for pairing mode
  • Xbox: Hold pairing button for 3 seconds
  • 8BitDo: Varies by model, check manual
4

Select Profile

Pick the profile that matches your workflow: Claude Code, Gemini CLI, Codex, or Terminal. The physical button meanings stay consistent when you switch.

  • Your first 7 days include every profile and all Pro features, no card required
  • After the trial, the Free tier keeps the Claude Code profile with its default mappings
  • Pro unlocks all profiles and mode switching for €4.99/month
5

Choose Native or Optimized

Start in Native mode, which needs no tool configuration. If you want richer tool-specific actions, open Settings and review the exact optimized bindings before installing.

  • UltraGrip checks for binding conflicts before writing
  • The original tool config is backed up and can be restored
  • If a config changes after installation, UltraGrip falls back to Native mode instead of guessing

Next Steps

Learn Claude Code Mappings

Master the pre-configured controls for AI-assisted development.

Tune Your Settings

Adjust stick deadzone and trigger sensitivity, and set up AI-enhanced voice dictation.

Troubleshooting

Controller not detected

Ensure your controller is properly connected. Try unplugging and reconnecting. For Bluetooth, remove the device and pair again. Check that the controller works in system settings.

Input not working (macOS)

Grant Accessibility permission: System Settings > Privacy & Security > Accessibility. Add Ultragrip to the allowed apps list, then restart Ultragrip.

Window titles not detected (macOS)

Context-aware dictation needs the Screen Recording permission to read window titles: System Settings > Privacy & Security > Screen Recording. Without it, Ultragrip still detects app names but window titles stay empty. Restart the app after granting.

Voice input not responding

Check microphone permissions in system settings. Ensure the R2 trigger is fully pressed and look for the "Listening..." indicator. Hold R2 for ordinary push-to-talk, or double-tap it to lock recording. Voice dictation needs an internet connection.