/GpdControl

Decky Plugin for GPD Controls

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

GpdControl - Decky Plugin

Decky Plugin that replicates some of the Gpd WinControls functionality.

plugin image

Prerequisites

RGB control currently has been hardcoded to only work on the GPD Win 4 6800u.

If you wish to test RGB control other variants of the Win 4 and get them added to this project, leave a github issue with your dmi product name

you can get the product name via running:

cat /sys/devices/virtual/dmi/id/product_name

Alternatively, you can install the plugin and find the device name at the bottom of the plugin.

Install

Prerequisites

Decky Loader must already be installed.

Quick Install / Update

Run the following in terminal, then reboot. Note that this works both for installing or updating the plugin

curl -L https://github.com/aarron-lee/GpdControl/raw/main/install.sh | sh

Manual Install

Download the latest release from the releases page

Unzip the tar.gz file, and move the GpdControl folder to your $HOME/homebrew/plugins directory

then run:

sudo systemctl restart plugin_loader.service

then reboot your machine.

Manual build

Dependencies:

  • Node.js v16.14+ and pnpm installed
git clone https://github.com/aarron-lee/GpdControl.git

cd GpdControl

# if pnpm not already installed
npm install -g pnpm

pnpm install
pnpm update decky-frontend-lib --latest
pnpm run build

Afterwards, you can place the entire GpdControl folder in the ~/homebrew/plugins directly, then restart your plugin service

sudo systemctl restart plugin_loader.service

Attribution

Big thanks to pelrun's pyWinControls for the original gpd win control tool (GPL 3.0)

  • vendored and modified for use here

Built using Decky Plugin Template: https://github.com/SteamDeckHomebrew/decky-plugin-template/

Vendored python dependency for hid.py

  • hid.py v1.0.5 by Austin Morton, MIT License. unmodified file here