How to Configure Key Mapping

Key Mapping lets you assign keyboard, mouse, or gamepad inputs to touch actions on the phone screen. You first create mapping profiles in the global editor, then assign a profile to each phone individually.

📋

Prerequisites

  • A phone is already connected and screen mirroring is active
  • If you want to map gamepad inputs, make sure your gamepad is connected first
  • For best results, start the game before configuring mappings so coordinates are accurate

Part 1: Create Mapping Profiles

All mapping profiles are managed in a global editor. Open it once and configure everything there.

01

Step 1: Open the Mapping Editor

  1. Click the Tools menu in the top menu bar
  2. Select Input Mapping from the dropdown
  3. The Input Mapping Settings window will open
02

Step 2: Create a Profile

Mappings are organized in profiles — create one profile per game.

  1. In the editor, the Mapping Profile selector is shown at the top of the window — use it to switch between profiles
  2. Click New and enter a name (e.g. the game name) to create a new profile
  3. Click Copy to duplicate an existing profile
  4. Switch between profiles anytime from the dropdown
03

Step 3: Add Mappings

Select an input source, choose a behavior, then click Add New Mapping.

  1. Choose the input source: Keyboard, Mouse, or Gamepad
  2. Choose the mapping behavior (see table below)
  3. Click Add New Mapping — press the desired key/button — set the screen coordinate — save
💡 All changes take effect immediately. No restart needed.

Mapping Behavior Reference

Touch
Tap a single point on the screen
Swipe
Drag from one point to another
Multi-Touch Tap
Tap multiple screen points simultaneously
Cycle Touch
Cycle through multiple positions on each press
Play Macro
Trigger a pre-recorded macro sequence
Use Stick (gamepad)
Map an analog stick to camera, drag, or cursor movement
Cursor Click (gamepad)
Use the cursor controlled by a stick to click on screen
Switch Layer
Switch to a different mapping layer when triggered

Part 2: Assign a Profile to a Phone

Profiles created in the editor are not automatically active. You need to assign one to each phone individually.

04

Step 4: Assign a Profile to a Phone

  1. Find the KM button at the top of the phone panel in the screen mirror view
  2. Click KM — the Select KeyMapping Profile dialog will open
  3. The dialog lists all available profiles
  4. Click the profile name you want to apply to this phone
  5. The dialog closes and the mapping activates immediately
  6. The KM button turns yellow to indicate an active profile
💡

Tips

  • Name profiles after the game — makes switching fast when you play different games
  • The overlay on the screen mirror shows all active mapping points visually
  • Use layers when a game needs different key configs for different modes — switch with Switch Layer mapping
  • On the screen mirror, the overlay shows all mapping touch points — click any point to jump directly to its edit dialog
  • In the KM profile picker, toggle Show Feedback to see real-time visual feedback when inputs are triggered (flash on touch, trail on swipe, joystick HUD for stick)