Gamepad mode
On this page
What the computer needs
In gamepad mode, the server makes a virtual game controller on the computer. Games see it as a connected controller. The type of controller is different on each operating system.
| Computer | What the computer sees | What you must do |
|---|---|---|
| Windows | An Xbox 360 controller. | Install the gamepad driver, ViGEmBus, one time. See The Windows driver. |
| Linux | A game controller with the name ilopad Virtual Gamepad. Its buttons have the Xbox positions: A is the bottom button, Y is the top button. | Nothing more. The server makes the controller in the same way that it makes the virtual mouse and keyboard. |
| macOS | No controller. | Gamepad mode is not available on macOS. See macOS. |
The Windows driver
ViGEmBus is an open-source Windows driver. With it, the server can make a virtual Xbox controller. Windows asks for your permission before it installs the driver. You can install the driver in two ways.
When you install the server
The Windows installer installs the driver when you install ilopad for the first time. Windows asks for permission to install it. Older installers did not install the driver. If you click No, or if an older installer installed ilopad, install the driver from the app. An update does not install the driver.
From the app
- Connect the app to the server.
- Tap the mode button
at the right of the toolbar. - Tap Gamepad
. The card Gamepad needs a driver opens. - Tap Install Driver.
- On the computer, approve the Windows permission prompt.
- Wait until Windows installs the driver. The app then opens gamepad mode.
If the installation fails, the card shows The driver was not installed. Check the computer for a permission prompt, then try again. The card also shows this message if it gets no result in 90 seconds. Tap Try Again.
If you do not want the driver, tap Not Now. Touchpad, pointer and pencil modes work without it.
If the driver is on the computer, but the server cannot make a controller, the app shows Gamepad not available on this computer. The server log shows the cause. See Logs.
macOS
At this time, the server for macOS cannot make a virtual game controller. When you connect to a Mac:
- The mode menu does not show Gamepad.
- If the app was in gamepad mode, it changes to touchpad mode. The card Gamepad not available on this computer gives the reason.
- Touchpad, pointer and pencil modes work as usual.
The Gamepad tab of the Input Testing window also works on a Mac. It shows the controllers that are connected to the Mac. See Test the gamepad.
The gamepad screen
Gamepad mode works on the iPhone and on the iPad, in landscape and in portrait. The app has a different arrangement of the controls for each orientation.
The toolbar has these items, from left to right:
| Item | What it does |
|---|---|
| The same as in the other modes. See Connection state. | |
| Opens the list of layouts. See Save and select layouts. | |
| Opens and closes the layout editor. See Change the layout. | |
| Turns the steering wheel on or off. See The steering wheel. | |
| Opens the app settings. | |
| Changes to a different mode. | |
| Hides the toolbar. To show it again, tap the tab at the top center of the screen. |
On a narrow toolbar, for example on an iPhone in portrait, some items move into a menu. Layouts
, Steering Wheel
and Settings
are then in the More controls
menu.
The first time that you open gamepad mode, a guide points at Edit layout
and then at Layouts
. Tap Next. Then tap Got It.
The controls
The Standard layout has 16 controls. The table gives the name of each control on an Xbox controller. Windows sees an Xbox controller.
| In the app | Type | On the computer |
|---|---|---|
| Left stick | Analog | Left stick |
| Right stick | Analog | Right stick |
| D-pad | Digital, four directions | D-pad |
| A B X Y | Digital | A, B, X, Y |
| L1 R1 | Digital | Left bumper (LB), right bumper (RB) |
| L2 R2 | Digital. A press is a full pull. | Left trigger (LT), right trigger (RT) |
| Sel | Digital | Back |
| Start | Digital | Start |
| L3 R3 | Digital | Left stick press, right stick press |
| Digital | Xbox (Guide) button |
How the controls respond
- Sticks. Touch the stick circle. The knob moves to your finger. The farther your finger is from the center, the more the stick moves. When you lift your finger, the stick goes back to the center.
- D-pad. Touch an arm. You can also slide your finger from one arm to a different arm. The D-pad sends one direction at a time. It does not send diagonal directions. A touch at the center sends no direction.
- Buttons. A button stays pressed while your finger is on it. You can press two or more buttons at the same time.
- A touch stays with its control. If you slide your finger off a button, the button stays pressed until you lift your finger. If you slide your finger onto a different button, that button stays released.
- Haptic feedback. A button or a custom key gives a light tap when you press it. The sticks and the D-pad give no tap. To turn off the tap, see Gamepad settings.
To use L3 or R3, press the L3 or R3 button. A press on the stick circle does not send L3 or R3.
The steering wheel
The steering wheel uses the motion of the device to move the left stick. Use it for driving games.
- Hold the device in landscape, in the position that you want as the center.
- Tap Steering Wheel
in the toolbar. The button shows that it is on. - To move the stick left or right, tilt the device to the left or to the right.
- To move the stick up or down, tilt the device forward or back.
- To stop, tap Steering Wheel
again. The left stick goes back to the center.
- Center. When you turn on the steering wheel, the position of the device becomes the center. To set a new center, turn off the steering wheel. Then turn it on again.
- Range. A tilt of 45 degrees from the center moves the stick fully. You cannot change this angle.
- Orientation. The steering wheel locks the screen in its current landscape orientation. When you turn it off, the screen can turn again.
- Invert. If the left stick of the layout has Invert stick Y axis on, the steering wheel also inverts the up and down direction.
The steering wheel is off each time that you open gamepad mode.
Custom keys
A custom key is a button that sends keyboard keys to the computer. It does not send controller buttons. Use it for a game action that has no controller button, for example a map key or a menu key.
Add a custom key
- Tap Edit layout
in the toolbar. - Tap Add key
, the key cap icon below the Edit layout
button. - On the New Button screen, type a name in Button name. The key shows this name.
- Tap Add Action.
- On the Custom Shortcut screen, tap the modifiers and the keys.
- Tap Add Keys.
- Tap Save. The new key shows at the center of the screen.
- Drag the key to the position that you want.
- To save the layout, tap Edit layout
.
The keys of one action go to the computer together, as one shortcut. A key can have more than one action. Each action can stop or continue. The editor is the same as the button editor in pencil mode. For all the details, see The button editor.
Change or delete a custom key
- Tap Edit layout
. - Tap the custom key to select it.
- To change it, tap the key again, or tap the pencil button below it.
- To delete it, tap the red button with the cross
below it. Then tap Delete.
A custom key is part of the layout. It is in the portrait and the landscape arrangement of the same device. You can put it in a different position in each orientation. When you delete it, the app removes it from the two orientations.
Change the layout
In the layout editor, you can move, resize and hide each control, and add custom keys.
- Tap Edit layout
in the toolbar. The controls show on a blue grid. - Tap a control to select it. A ring shows around it, and a row of round buttons shows below it.
- Make your changes. The table below gives the changes that you can make.
- Tap Edit layout
again. The app closes the editor and saves your changes.
| To do this | Do this |
|---|---|
| Move a control | Drag it. Lines show when an edge aligns with a different control. A control cannot go outside the grid. If a control is too small to grab, it shows a move handle in its row. Drag the handle. |
| Resize a control | Drag one of its corner dots. Each type of control has a minimum size. |
| Hide or show a standard control | Tap the eye button |
| Invert the up and down direction of a stick | Select the stick. Tap the button with the up and down arrows |
| Change the D-pad shape | Select the D-pad. Move the Spread slider. More spread moves the four arms apart. It also makes the center area that sends no direction larger. |
| Change the stick knob | Select a stick. To make the knob larger or smaller, move the Handle slider. |
| Round the corners of a custom key | Select the key. Move the Radius slider. |
| Add a custom key | Tap Add key |
You cannot add a standard control. If you hide a standard control, you can show it again with the eye button
.
The Standard layout
The app includes one layout, Standard. The app does not change it. If you edit Standard, the app saves your changes as a new layout. Its name is Custom Layout. If that name is already in use, the app adds a number, for example Custom Layout 2. The new layout becomes active. If you open and close the editor without a change, the app makes no copy.
If you edit a layout that you saved, the app saves your changes into it when you tap Edit layout
to close the editor. It keeps the version from before your changes. To go back to that version, tap Revert "name". See Save and select layouts.
Orientation and device size
Each layout keeps a separate arrangement for portrait and for landscape. It also keeps a separate arrangement for four device sizes: small iPhones, for example the iPhone SE, other iPhones, the iPad mini, and larger iPads.
- The editor changes only the arrangement for the current device and the current orientation.
- To change the other orientation, turn the device while the editor is open. The editor keeps the changes that you made in the first orientation.
- Custom keys and Invert stick Y axis apply to the two orientations.
Save and select layouts
You can keep a different layout for each game. To open the list, tap Layouts
in the toolbar.
- Standard is first. It shows Built-in. You cannot rename or delete it.
- Your layouts are below it, in alphabetical order. Each row shows the number of controls.
- A check mark shows the active layout.
| To do this | Do this |
|---|---|
| Use a layout | Tap its row. |
| Save the current layout as a new layout | Tap Save As…. Type a name. Then tap Save. The new layout becomes active. |
| Go back to the version before your last edit | Tap Revert "name". Then tap Revert. This goes back one step only. It does not change the name. The item shows only when an earlier version is available. |
| Rename a layout | Tap the button with three dots on its row. Then tap Rename. You can also swipe the row to the left. |
| Delete a layout | Tap the button with three dots on its row. Then tap Delete. You can also swipe the row to the left. To confirm, tap Delete again. |
If you delete the active layout, Standard becomes active. To close the list, tap Done.
The app keeps your layouts on the device. The same layouts are available for all servers. The app does not copy them to your other devices.
Gamepad settings
Gamepad mode has no page of its own in Settings. The Settings
button in the gamepad toolbar opens the main Settings screen. These settings apply to gamepad mode:
| Setting | Where | What it does | Default |
|---|---|---|---|
| Haptic Feedback | Settings, General | Gives a light tap when you press a button or a custom key. | On |
| Steering Wheel | Gamepad toolbar | Moves the left stick when you tilt the device. | Off |
| Invert stick Y axis | Layout editor, row of a stick | Inverts the up and down direction of that stick. Each stick and each layout has its own setting. | Off |
| Spread | Layout editor, D-pad | Moves the arms of the D-pad apart. | Lowest: the arms touch |
| Handle | Layout editor, stick | Sets the size of the stick knob. | Middle |
| Radius | Layout editor, custom key | Sets how round the corners of the key are. | Lowest: the same corners as the other controls |
| Don't show this again | The gamepad card: Gamepad needs a driver or Gamepad not available on this computer | Stops the card from opening when you did not ask for it. When you select Gamepad in the mode menu, the card always opens. | Off |
For Keep Screen Awake, Auto-Hide, Hide Delay and the other settings of the app, see General settings.
Limits
| Subject | Limit |
|---|---|
| macOS | Gamepad mode is not available when you connect to a Mac. |
| Windows | Gamepad mode needs the ViGEmBus driver. The computer sees an Xbox 360 controller. That controller has no Share button. |
| Number of controllers | The server makes one virtual controller for each computer. If two devices are in gamepad mode, they control the same controller. You cannot use two devices as two players. |
| Triggers | L2 and R2 are digital. A press sends a full pull. You cannot pull a trigger halfway. |
| D-pad | The D-pad sends one direction at a time. It sends no diagonal directions. |
| Vibration | A game cannot make the device vibrate. The haptic tap comes from the app, not from the game. |
| Motion | The game does not receive the motion of the device. Only the steering wheel uses the motion, and it moves only the left stick. |
| Custom keys | A custom key sends a tap of its keys. It cannot keep a key pressed. |
| App in the background | When the app goes to the background, it releases all buttons and puts the two sticks back at the center. |
| Connection lost | When a device disconnects, the server releases each controller button that the device held. |
| Steering wheel | The steering wheel works only in landscape. The full tilt is 45 degrees. You cannot change it. |
Test the gamepad
The Input Testing window of the server has a Gamepad tab. It shows the buttons and the sticks that the server receives from the app. For the steps, see Test the input: Gamepad.
The device shows in the list after its first gamepad input. Until then, the tab shows No controllers connected.
On Windows, the tab shows that the input gets to the server. To examine the Xbox controller itself, use a game or a controller test program.