11# Handheld Daemon (HHD)
22Handheld Daemon is a project that aims to provide utilities for managing handheld
33devices.
4- With features ranging from TDP controls, to controller remappings, and gamescope
5- session management.
4+ Right now, it features a fully functional controller emulator that exposes gyro,
5+ paddles, LEDs and QAM across Steam, Yuzu, Dolphin and others.
6+ It brings all supported devices up to parity with Steam Deck.
7+ Read [ supported devices] ( #supported-devices ) to see if your device is supported.
68
79This configuration is exposed through an API, and there is already a Decky
810plugin for it ([ hhd-decky] ( https://github.com/hhd-dev/hhd-decky ) ) and a web
911app for it ([ hhd.dev] ( https://hhd.dev ) ) that also works locally with Electron
1012([ hhd-ui] ( https://github.com/hhd-dev/hhd-ui ) ).
1113
12- It is the aim of this project to provide generic hid-based emulators for most
13- mainstream controllers (xbox Elite, DS4, PS5, Joycons), so that users of devices
14- can pick the best target for their device and its controls, which may change
15- depending on the game.
16-
17- * Supported Devices* :
18- - Legion Go
19- - ROG Ally
20- - GPD Win 4, Win Mini, and Win Max 2 2023
21- - Ayaneo Air Plus
14+ In addition, a new TDP plugin (currently non-functional) is in the works, that
15+ will allow both vendor specific and vendor independent TDP controls.
16+ Check out [ adjustor] ( https://github.com/hhd-dev/adjustor ) !.
2217
2318* Current Features* :
2419- Fully functional DualSense and Dualsense Edge emulation
@@ -41,18 +36,39 @@ depending on the game.
4136 - Webapp on https://hhd.dev and through Electron.
4237- Built-in updater.
4338
44- * Planned Features (in this order)* :
45- - Steam Deck controller emulation
46- - No weird glyphs
47- - TDP Plugin
48- - Will provide parity with Legion Space/Armory crate, hardware is already reverse
49- engineered for the Legion Go.
50- - High-end Over/Downclocking Utility for Ryzen processors
51- - By hooking into the manufacturer ACPI API of the Ryzen platform,
52- it will expose all TDP related parameters manufacturers have access to
53- when spec'ing laptops.
54- - No memory-relaxed requirement
55- - Safe, as it is the method used by manufacturers (provided you stay within limits).
39+ ## <a name =" devices " ></a >Supported Devices
40+ The following devices have been verified to work correctly, with QAM, RGB remapping,
41+ Touchpad, and Gyro support.
42+
43+ - Legion Go
44+ - ROG Ally
45+ - GPD Win
46+ - Win 4
47+ - Win Mini
48+ - Win Max 2 2023
49+ - Ayaneo
50+ - Air Plus
51+ - 2/2s (experimental)
52+ - GEEK, GEEK 1S (experimental)
53+ - AOKZOE
54+ - A1
55+ - A1 Pro (experimental)
56+
57+ In addition, Handheld Daemon will attempt to work on Ayaneo and GPD Win devices
58+ that have not been verified to work (controller emulation will be off on first start).
59+ If everything works and you fix the gyro axis for your device, open an issue
60+ so that your device can be added to the supported list.
61+ The touchpad will not work without being on the supported list on the current version.
62+
63+ RGB support is not yet available for GPD Win 4 and Ayaneo devices, but is
64+ being investigated.
65+ The RGB settings of Ayaneo require direct writes to the Embedded Computer, which
66+ is considered dangerous.
67+ GPD Win 4 does not support RGB remapping on Windows, but there is a chance it
68+ is possible.
69+
70+ Ayaneo devices do not currently have support for holding the power button to open
71+ the steam menu settings.
5672
5773## Installation Instructions
5874You can install the latest stable version of ` hhd ` from PyPi (recommended), AUR,
0 commit comments