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 & Launch

Run the installer and grant necessary permissions for input synthesis (macOS requires Accessibility permissions).

  • macOS: Allow in System Preferences → Security & Privacy → Accessibility
  • Windows: May require administrator privileges
  • Linux: Configure udev rules if needed
3

Connect Controller

Plug in your gamepad via USB or pair via Bluetooth. Ultragrip auto-detects most SDL2-compatible controllers.

  • 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

Choose your workflow: Claude Code, VS Code, Terminal, or Custom. Switch anytime with the Triangle/Y button.

  • Profiles auto-save per application
  • Hot-reload config files for testing
  • Share configs with your team

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 permissions: System Preferences → Security & Privacy → Privacy → Accessibility. Add Ultragrip to the allowed apps list.

Voice input not responding

Check microphone permissions in system settings. Ensure R2 trigger is fully pressed (you should see "Listening..." indicator). Test microphone in system sound settings.