Skip to content

Valkirie/HandheldCompanion

Repository files navigation

Download Latest discord YouTube Channel Donations Support me on Patreon

Handheld Companion

A touch optimized GUI to increase your handheld gaming computer experience. Features include:

  • Motion control a.k.a. gyro control through a device's inertial measurement unit (IMU, Gyroscope and Accelerometer) or external sensor. Settings availible for racing, 1st and 3rd person gaming and emulator support.
  • Quicktools overlay, with easy access to various settings and informatio such as TDP, Auto TDP, GPU, Screen Hz, Framelimiter, Resolution, Brightness, Volume, Powermode control and battery level.
  • Virtual controller simulation of Microsoft Xbox 360 Controller and Sony DualShock 4 Controller.
  • Profile settings system, automatic detection of active game and applying of settings.
  • Gamepad remapping to mouse and keyboard, gamepad joystick and trigger deadzone adjustements.
  • PS Remote Play support with DS4 controller, including motion and touchpad.
  • 3D Controller overlay for stream recordings.
  • Hotkeys for various conveniences.

Use cases

A few examples of the most common use cases are:

  • You want to add universal motion controls (UMC) to any game.
  • You want to add high-precision motion controls to your Windows game library through Steam.
  • You want to play your Sony Playstation 4 library through PlayStation Now or PS4 Remote Play.
  • You want to enjoy all your Wii, WiiU and Switch games with full motion controls through UDP motion control protocol.

Youtube Channel

Supported Systems

The software is built for Windows 10/Windows 11 (x86 and amd64).

Supported Devices

  • ASUS ROG Ally
  • Lenovo Legion Go
  • MSI Claw A1M
  • AOKZOE A1 and A1 Pro
  • AOKZOE A2
  • Steam Deck (LCD, OLED)
  • AYA Neo and its different versions
  • AYA Neo Next and its different versions
  • AYA Neo Air and it's different versions
  • AYA Neo 2, Geek, 2S Geek 1S
  • AYA Neo KUN
  • AYA Neo Flip DS and Flip KB
  • AYA Neo Slide
  • ONEXPLAYER X1 (Intel)
  • ONEXPLAYER OneXFly
  • ONEXPLAYER 2 and 2 Pro
  • ONEXPLAYER MINI and its different versions (Intel, AMD, Gundam)
  • GPD WIN Max 2 (INTEL, AMD)
  • GPD Win 2
  • GPD Win 3
  • GPD Win 4 (8640U and 8840U)
  • GPD Win Mini (7640U and 7840U)
  • Ayn Loki (all models)

Supported Sensors

  • Bosch BMI160 (and similar)
  • USB IMU (GY-USB002)

Supported Languages

  • English
  • French
  • German
  • Italian
  • Japanese
  • Portuguese (Brazilian)
  • Spanish
  • Chinese (Simplified)
  • Chinese (Traditional)

Partners

image

DroiX, are trusted and respected sellers for PC gaming handhelds including GPD, AYA NEO, ONEXPLAYER & AOKZOE. Shipping worldwide with local return centers, their expert customer service is there to provide support, answer any queries and ensure you get the best support for your purchase. Try them today!

Droix Discord

Visuals

image image image

Overlay

The software has multiple built-in performance metric overlay options.

image

QuickTools

On the fly adjustment of TDP (global and profile), brightness, screen resolution and frequency, hotkeys and motion control profile settings. Summonable with a user defined button combination (including certaind supported devices mapped special keys). Window can be aligned how the user sees fit (left, right, floating).

image Quicktools power control with Into the Breach.

image Quicktools profile settings with Borderlands Pre-Sequel.

Virtual touchpad

Virtual touchpad on top of your gaming sessions. The virtual touchpad is used to mimic the DualShock 4 physical touchpad and grants maximum compatibility with PS Now, PS Remote software suites and games that make specific use of the Steampad touchpads.

Touchpad

Virtual Touchpad input demonstration with PS Remote Play

Example02

PS Remote Play, The Last of Us Part 2

3D Controller

Display a 3D virtual controller, showcasing the motion of the device and all button interaction, individual button presses, joystick and trigger positions. The following 3D models are availible.

  • OEM controller (Ayaneo Pro, Ayaneo Next, OneXPlayer Mini)
  • Emulated controller (DualShock 4, Xbox 360)
  • Xbox One controller
  • ZDO+ controller
  • Fisher-Price controller
  • Machenike HG510
  • 8BitDo Lite 2
  • Nintendo 64
  • Dual Sense

image

Contribute

Bugs & Features

Found a bug and want it fixed? Open a detailed issue on the GitHub issue tracker! Have an idea for a new feature? Let's have a chat about your request on Discord.

Questions & Support

Please respect that the GitHub issue tracker isn't a helpdesk. We offer a Discord server, where you're welcome to check out and engage in discussions!

Donation

If you would like to support this project, please consider making a donation to BenjaminLSR via PayPal.

Handheld Companion relies on ViGEmBus driver and ViGEmClient libraries as well as HidHide kernel-mode filter driver. Therefore, we strongly encourage you in donating to Nefarius via PayPal for continued maintenance and development.

Installation

Installers are available as an all-in-one setup. Run the install.exe as administrator and you'll be set!

Credits & Libraries

Licensing

imageimageimageimage

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

We believe in the fair use of open-source solutions. We expect OEMs to come forward before distributing our solution with their devices. This way we can work together to make your device and our solution compatible in the best possible way. We reserve the right to take any action necessary to block partial or full access to the application to any entities that do not comply with the license or fair use principle.