Skip to content

SaveEditors/x360controller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

x360 Controller

x360 Controller

x360 Controller lets a modded Xbox 360 receive controller input from an Android phone or a Windows PC over the local network.

Use it when you want:

  • an Android phone to act as a standalone Xbox 360 controller host
  • a Windows app to pass keyboard or PC controller input to the console
  • one Xbox 360 plugin, controlleremu.xex, installed through DashLaunch

Downloads

For v1.0, use the GitHub Releases page. The release should include these five files:

File Use
360controller.apk Android app
x360-controller-windows.exe Windows app
360cli.exe Windows command-line host
controlleremu.xex Xbox 360 DashLaunch plugin
controlleremu.ini Default Xbox plugin network config

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

Requirements

  • Xbox 360 with RGH/JTAG
  • Dashboard 2.0.17559.0
  • DashLaunch plugin setup
  • FTP or another way to copy files to the console hard drive
  • Android device or Windows PC on the same local network as the console
  • Default network port 3000 open on the host device

Retail Xbox 360 consoles are not supported.

Quick Start

  1. Download controlleremu.xex and controlleremu.ini from the v1.0 release.

  2. Open controlleremu.ini on your PC and replace the default IPs with your actual host IP. The Android app shows the phone IP. The Windows app shows the PC IP in its PC status chip.

  3. Copy both files to Hdd:\Plugins\ on the Xbox 360:

    Hdd:\Plugins\controlleremu.xex
    Hdd:\Plugins\controlleremu.ini
    
  4. Add controlleremu.xex as a DashLaunch plugin.

  5. Reboot the console.

  6. Start the Android app or Windows app, then connect from the console plugin.

Full setup steps are in Install Guide.

Screenshots

Android host screen Android controller screen

Windows app screen

Android App

Install 360controller.apk on your Android device. The app can run as the standalone controller host, so a PC is not required when using Android mode.

Open the app, start the host, and use the IP address shown in the app when you edit controlleremu.ini. Keep the port at 3000 unless you changed it in both places.

Windows App

Run x360-controller-windows.exe on a Windows PC connected to the same local network as the console. The Windows app can host controller input from a keyboard or a PC controller.

Use the PC's local IPv4 address shown in the Windows app PC status chip in controlleremu.ini, and keep the port at 3000 unless you changed it in both places.

Windows CLI

Run 360cli.exe when you want the Windows host without the GUI. It uses the same default port, keyboard bindings, and PC controller support as the Windows app.

Common commands:

360cli.exe --help
360cli.exe --show-keys
360cli.exe --port 3000

Full CLI usage is in Windows CLI Guide.

Known Issue In v1.0

Button holds do not behave 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.

Documentation

Repository Layout

Path Contents
android/ Android app source, Gradle project, tests, and Android assets
windows/ Windows GUI/CLI Python source, Windows build scripts, icon, and public INI profiles
dist/ v1.0 release artifacts users download
docs/ Installation, CLI, troubleshooting, FAQ, protocol, and release docs
scripts/ Root convenience wrappers that call the Windows build/run scripts
assets/ Controller artwork source and attribution files used by the apps/docs

Source And Distribution

Android app source is in android/. Windows app and CLI source is in windows/. The release artifacts are kept in dist/.

The v1.0 Xbox 360 plugin is distributed as the compiled controlleremu.xex binary. Xbox plugin/XEX source is not included in this public repository.

The public release files users need are the five downloads listed above.

Support

If setup fails, start with Troubleshooting. Most connection issues come from the console and host device being on different networks, the wrong host IP in controlleremu.ini, or port 3000 being blocked.

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

Credits And License

  • Upstream plugin project: UncreativeXenon/WirelessInput360
  • Upstream release used: 0.1.1
  • Project source and documentation are licensed under the MIT License. See LICENSE.
  • controlleremu.xex is distributed as a compiled binary release artifact.
  • Third-party components and redistributed binary/runtime pieces keep their own notices and licenses. See THIRD_PARTY_NOTICES.md.

About

Windows, Android, and Xbox 360 controller bridge for RGH/JTAG consoles.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors