Skip to content

FAQ.md

Latest commit

 

History

History
107 lines (70 loc) · 3.06 KB

FAQ.md

File metadata and controls

107 lines (70 loc) · 3.06 KB

FAQ

What consoles are supported?

x360 Controller is for RGH/JTAG Xbox 360 consoles using DashLaunch plugins. The documented dashboard is 2.0.17559.0.

Does this work on a retail Xbox 360?

No. Retail consoles cannot load the required plugin.

What files do I download for v1.0?

The v1.0 release should provide:

  • 360controller.apk
  • x360-controller-windows.exe
  • 360cli.exe
  • controlleremu.xex
  • controlleremu.ini

Edit controlleremu.ini before copying it to the console. The release defaults use documentation addresses, Android 192.0.2.2 and Windows 192.0.2.1; replace them with your actual phone or PC IP address.

Where do I put the Xbox files?

Put both files here:

Hdd:\Plugins\controlleremu.xex
Hdd:\Plugins\controlleremu.ini

Then add controlleremu.xex to DashLaunch and reboot.

What should controlleremu.ini contain?

For most users:

[Network]
ip=<host-ip>
port=3000
host1=android|<phone-ip-shown-in-app>|3000
host2=windows|<windows-pc-local-ip>|3000
order=host1,host2

Use the IP address shown in the Android app, or the PC IP shown in the Windows app PC status chip.

Can Android work without a PC?

Yes. The Android app can be the standalone host. Start the host in the app and put the phone IP shown in the app into controlleremu.ini.

Can Windows work without Android?

Yes. Run x360-controller-windows.exe or 360cli.exe on the PC, then put the PC's local IPv4 address into controlleremu.ini.

Do Android and Windows need to run at the same time?

No. Pick one host. Use Android mode or Windows mode.

Do button holds work in v1.0?

Not correctly. In v1.0, holding a button may be sent as repeated press and release events instead of one continuous hold. For example, holding Guide may open and close the Xbox Guide repeatedly instead of opening the power menu.

Use quick button presses where possible. Correct button-hold behavior is planned for v2.0 or a later update.

What port should I use?

Use port 3000 unless you have a specific reason to change it. If you change the port, change it in both the host app and controlleremu.ini.

Why does the console not connect?

Most connection issues are caused by:

  • wrong host IP address in controlleremu.ini
  • Android phone, Windows PC, and console not being on the same local network
  • port 3000 blocked by firewall or router settings
  • DashLaunch plugin not enabled
  • console not rebooted after changing plugin files or INI settings

See Troubleshooting for more checks.

What if the console has trouble booting after plugin setup?

Hold RB while powering on to bypass DashLaunch plugins. Then fix or remove the plugin entry in launch.ini.

Is Xbox plugin source code included in the v1.0 release?

No. The v1.0 release provides the Xbox plugin as controlleremu.xex. Android source is in android/, and Windows source is in windows/. Xbox plugin/XEX source is not included.

Where can I support the project?

Donations are optional. All donations go towards development: Support XeCLI on Ko-Fi.