ilopad
Manual

Gamepad mode

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.

ComputerWhat the computer seesWhat you must do
WindowsAn Xbox 360 controller.Install the gamepad driver, ViGEmBus, one time. See The Windows driver.
LinuxA 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.
macOSNo 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

  1. Connect the app to the server.
  2. Tap the mode button at the right of the toolbar.
  3. Tap Gamepad . The card Gamepad needs a driver opens.
  4. Tap Install Driver.
  5. On the computer, approve the Windows permission prompt.
  6. 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 ViGEmBus is already on the computer, for example from a different program, the server uses that driver. ilopad does not ask you to install it again. When you uninstall ilopad, the uninstaller does not remove that driver.

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.

Gamepad mode on an iPad in landscape, with two sticks, a D-pad, the A B X Y buttons and the shoulder buttons
Gamepad mode on an iPad, with the Standard layout.
Gamepad mode on an iPhone in landscape, with the same controls closer together
The same layout on an iPhone. Each device size has its own arrangement.

The toolbar has these items, from left to right:

ItemWhat it does
Power button and connection statusThe same as in the other modes. See Connection state.
LayoutsOpens the list of layouts. See Save and select layouts.
Edit layoutOpens and closes the layout editor. See Change the layout.
Steering WheelTurns the steering wheel on or off. See The steering wheel.
SettingsOpens the app settings.
Mode button (Gamepad)Changes to a different mode.
Hide toolbarHides 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 appTypeOn the computer
Left stickAnalogLeft stick
Right stickAnalogRight stick
D-padDigital, four directionsD-pad
A B X YDigitalA, B, X, Y
L1 R1DigitalLeft bumper (LB), right bumper (RB)
L2 R2Digital. A press is a full pull.Left trigger (LT), right trigger (RT)
SelDigitalBack
StartDigitalStart
L3 R3DigitalLeft stick press, right stick press
Round button with the ilopad logoDigitalXbox (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.

  1. Hold the device in landscape, in the position that you want as the center.
  2. Tap Steering Wheel in the toolbar. The button shows that it is on.
  3. To move the stick left or right, tilt the device to the left or to the right.
  4. To move the stick up or down, tilt the device forward or back.
  5. 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 and the on-screen left stick control the same stick. Do not use the on-screen left stick while the steering wheel is on. The other controls work as usual.

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

  1. Tap Edit layout in the toolbar.
  2. Tap Add key , the key cap icon below the Edit layout button.
  3. On the New Button screen, type a name in Button name. The key shows this name.
  4. Tap Add Action.
  5. On the Custom Shortcut screen, tap the modifiers and the keys.
  6. Tap Add Keys.
  7. Tap Save. The new key shows at the center of the screen.
  8. Drag the key to the position that you want.
  9. 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

  1. Tap Edit layout .
  2. Tap the custom key to select it.
  3. To change it, tap the key again, or tap the pencil button below it.
  4. 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.

A custom key sends its keys when you touch it. Then it releases them immediately. It does not keep a key pressed while your finger stays on it. Thus a custom key cannot replace a key that you must hold in a game, for example a movement key.

Change the layout

In the layout editor, you can move, resize and hide each control, and add custom keys.

The gamepad layout editor on an iPad: the controls on a blue grid, the left stick selected with a row of round buttons and a Handle slider below it
The layout editor. The selected stick shows its buttons and its Handle slider.
  1. Tap Edit layout in the toolbar. The controls show on a blue grid.
  2. Tap a control to select it. A ring shows around it, and a row of round buttons shows below it.
  3. Make your changes. The table below gives the changes that you can make.
  4. Tap Edit layout again. The app closes the editor and saves your changes.
To do thisDo this
Move a controlDrag 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 controlDrag one of its corner dots. Each type of control has a minimum size.
Hide or show a standard controlTap the eye button . In the editor, a hidden control shows a cross. It does not show on the gamepad screen. You cannot delete a standard control. You can only hide it.
Invert the up and down direction of a stickSelect the stick. Tap the button with the up and down arrows . When the inversion is on, the button shows a color.
Change the D-pad shapeSelect 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 knobSelect a stick. To make the knob larger or smaller, move the Handle slider.
Round the corners of a custom keySelect the key. Move the Radius slider.
Add a custom keyTap Add key . See Custom keys.

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 thisDo this
Use a layoutTap its row.
Save the current layout as a new layoutTap Save As…. Type a name. Then tap Save. The new layout becomes active.
Go back to the version before your last editTap 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 layoutTap the button with three dots on its row. Then tap Rename. You can also swipe the row to the left.
Delete a layoutTap 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:

SettingWhereWhat it doesDefault
Haptic FeedbackSettings, GeneralGives a light tap when you press a button or a custom key.On
Steering Wheel Gamepad toolbarMoves the left stick when you tilt the device.Off
Invert stick Y axisLayout editor, row of a stickInverts the up and down direction of that stick. Each stick and each layout has its own setting.Off
SpreadLayout editor, D-padMoves the arms of the D-pad apart.Lowest: the arms touch
HandleLayout editor, stickSets the size of the stick knob.Middle
RadiusLayout editor, custom keySets how round the corners of the key are.Lowest: the same corners as the other controls
Don't show this againThe gamepad card: Gamepad needs a driver or Gamepad not available on this computerStops 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

SubjectLimit
macOSGamepad mode is not available when you connect to a Mac.
WindowsGamepad mode needs the ViGEmBus driver. The computer sees an Xbox 360 controller. That controller has no Share button.
Number of controllersThe 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.
TriggersL2 and R2 are digital. A press sends a full pull. You cannot pull a trigger halfway.
D-padThe D-pad sends one direction at a time. It sends no diagonal directions.
VibrationA game cannot make the device vibrate. The haptic tap comes from the app, not from the game.
MotionThe game does not receive the motion of the device. Only the steering wheel uses the motion, and it moves only the left stick.
Custom keysA custom key sends a tap of its keys. It cannot keep a key pressed.
App in the backgroundWhen the app goes to the background, it releases all buttons and puts the two sticks back at the center.
Connection lostWhen a device disconnects, the server releases each controller button that the device held.
Steering wheelThe 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 Gamepad tab of the Input Testing window: a controller drawing with the pressed buttons in blue, and bars for each axis
The Gamepad tab of the Input Testing window. The pressed buttons and triggers show in blue.

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.