files:
- setup:
filename: Skull-HQ-Setup-3.2.0.exe
url: https://skull-hq.s3.us-east-1.amazonaws.com/Skull-HQ+Setup+3.2.0.exe
- bridge:
filename: skullcandy-hq-linux.tar.gz
url: https://github.com/Bali0531-RC/skullcandy-hq-linux/archive/refs/heads/main.tar.gz
game:
exe: $HOME/.local/share/skullcandy-hq/launch-skullhq.sh
install_complete_text: "Done. Plug the SLYR Pro in over USB (not Bluetooth) before\
\ launching.\n\nIf the headset shows up as \"no device\", install the udev rule\
\ once (needs\nroot, which Lutris can't do during install), then re-plug:\n sudo\
\ curl -L https://raw.githubusercontent.com/Bali0531-RC/skullcandy-hq-linux/main/udev/99-skullcandy.rules\
\ -o /etc/udev/rules.d/99-skullcandy.rules\n sudo udevadm control --reload-rules\
\ && sudo udevadm trigger\n\nThis entry drives your SYSTEM Wine (Proton/GE can't\
\ do the headset HID).\nThe HID bridge runs as a user service: systemctl --user\
\ status hidbridge"
installer:
- extract:
dst: $CACHE/src
file: bridge
- execute:
command: bash "$CACHE/src/install.sh" --installer "$setup"
description: Installing Skull-HQ + native HID bridge (system Wine). Complete any
installer prompts that appear.
disable_runtime: true
system:
disable_runtime: true
description: "Installs Skull-HQ into a dedicated Wine prefix and wires up a native\
\ HID bridge (a hid.dll shim plus a small per-user helper service) so the headset's\
\ control protocol works under Wine. Uses the built-in \"linux\" runner to launch\
\ the app through the project's own wrapper, which pins it to system Wine \u2014\
\ required for the headset HID. Downloads the official Skull-HQ 3.2.0 installer\
\ from Skullcandy's server and the open-source bridge from GitHub."
game_slug: skullcandy-hq
gogslug: ''
humblestoreid: ''
installer_slug: skullcandy-hq-320
name: Skullcandy HQ
notes: "- Connect the SLYR Pro by USB before launching.\r\n- System Wine is required\
\ (the launcher uses /usr/bin/wine on purpose). Proton/\r\n GE-Proton can't do\
\ the headset HID GET_REPORT, so there is no Wine-version\r\n picker here.\r\n\
- Prerequisites must be installed system-wide first: wine, winetricks, python3.\r\
\n Arch/CachyOS: sudo pacman -S wine winetricks python\r\n- During install you'll\
\ see the Skull-HQ setup wizard and winetricks\r\n (vcrun2022, dotnet48), complete\
\ any prompts that appear.\r\n- One manual root step: the USB device needs a udev\
\ rule for non-root access.\r\n If the headset shows as \"no device\", run once\
\ and re-plug:\r\n sudo curl -L https://raw.githubusercontent.com/Bali0531-RC/skullcandy-hq-linux/main/udev/99-skullcandy.rules\
\ -o /etc/udev/rules.d/99-skullcandy.rules\r\n sudo udevadm control --reload-rules\
\ && sudo udevadm trigger\r\n- The HID bridge runs as a user service: systemctl\
\ --user status hidbridge\r\n- Tested with Skull-HQ 3.2.0 and the SLYR Pro (USB\
\ 34f0:2220) on Arch/CachyOS\r\n with Wine 11.x. Other Airoha-based Skullcandy\
\ headsets are likely to work but\r\n are unverified.\r\n- The install downloads\
\ ~190 MB (the official Skull-HQ installer) plus the small\r\n bridge tarball."
runner: linux
script:
files:
- setup:
filename: Skull-HQ-Setup-3.2.0.exe
url: https://skull-hq.s3.us-east-1.amazonaws.com/Skull-HQ+Setup+3.2.0.exe
- bridge:
filename: skullcandy-hq-linux.tar.gz
url: https://github.com/Bali0531-RC/skullcandy-hq-linux/archive/refs/heads/main.tar.gz
game:
exe: $HOME/.local/share/skullcandy-hq/launch-skullhq.sh
install_complete_text: "Done. Plug the SLYR Pro in over USB (not Bluetooth) before\
\ launching.\n\nIf the headset shows up as \"no device\", install the udev rule\
\ once (needs\nroot, which Lutris can't do during install), then re-plug:\n \
\ sudo curl -L https://raw.githubusercontent.com/Bali0531-RC/skullcandy-hq-linux/main/udev/99-skullcandy.rules\
\ -o /etc/udev/rules.d/99-skullcandy.rules\n sudo udevadm control --reload-rules\
\ && sudo udevadm trigger\n\nThis entry drives your SYSTEM Wine (Proton/GE can't\
\ do the headset HID).\nThe HID bridge runs as a user service: systemctl --user\
\ status hidbridge"
installer:
- extract:
dst: $CACHE/src
file: bridge
- execute:
command: bash "$CACHE/src/install.sh" --installer "$setup"
description: Installing Skull-HQ + native HID bridge (system Wine). Complete
any installer prompts that appear.
disable_runtime: true
system:
disable_runtime: true
slug: skullcandy-hq-320
steamid: null
version: 3.2.0
year: 2022
{
"game_slug": "skullcandy-hq",
"version": "3.2.0",
"description": "Installs Skull-HQ into a dedicated Wine prefix and wires up a native HID bridge (a hid.dll shim plus a small per-user helper service) so the headset's control protocol works under Wine. Uses the built-in \"linux\" runner to launch the app through the project's own wrapper, which pins it to system Wine \u2014 required for the headset HID. Downloads the official Skull-HQ 3.2.0 installer from Skullcandy's server and the open-source bridge from GitHub.",
"notes": "- Connect the SLYR Pro by USB before launching.\r\n- System Wine is required (the launcher uses /usr/bin/wine on purpose). Proton/\r\n GE-Proton can't do the headset HID GET_REPORT, so there is no Wine-version\r\n picker here.\r\n- Prerequisites must be installed system-wide first: wine, winetricks, python3.\r\n Arch/CachyOS: sudo pacman -S wine winetricks python\r\n- During install you'll see the Skull-HQ setup wizard and winetricks\r\n (vcrun2022, dotnet48), complete any prompts that appear.\r\n- One manual root step: the USB device needs a udev rule for non-root access.\r\n If the headset shows as \"no device\", run once and re-plug:\r\n sudo curl -L https://raw.githubusercontent.com/Bali0531-RC/skullcandy-hq-linux/main/udev/99-skullcandy.rules -o /etc/udev/rules.d/99-skullcandy.rules\r\n sudo udevadm control --reload-rules && sudo udevadm trigger\r\n- The HID bridge runs as a user service: systemctl --user status hidbridge\r\n- Tested with Skull-HQ 3.2.0 and the SLYR Pro (USB 34f0:2220) on Arch/CachyOS\r\n with Wine 11.x. Other Airoha-based Skullcandy headsets are likely to work but\r\n are unverified.\r\n- The install downloads ~190 MB (the official Skull-HQ installer) plus the small\r\n bridge tarball.",
"name": "Skullcandy HQ",
"year": 2022,
"steamid": null,
"gogslug": "",
"humblestoreid": "",
"runner": "linux",
"slug": "skullcandy-hq-320",
"installer_slug": "skullcandy-hq-320",
"script": {
"files": [
{
"setup": {
"filename": "Skull-HQ-Setup-3.2.0.exe",
"url": "https://skull-hq.s3.us-east-1.amazonaws.com/Skull-HQ+Setup+3.2.0.exe"
}
},
{
"bridge": {
"filename": "skullcandy-hq-linux.tar.gz",
"url": "https://github.com/Bali0531-RC/skullcandy-hq-linux/archive/refs/heads/main.tar.gz"
}
}
],
"game": {
"exe": "$HOME/.local/share/skullcandy-hq/launch-skullhq.sh"
},
"install_complete_text": "Done. Plug the SLYR Pro in over USB (not Bluetooth) before launching.\n\nIf the headset shows up as \"no device\", install the udev rule once (needs\nroot, which Lutris can't do during install), then re-plug:\n sudo curl -L https://raw.githubusercontent.com/Bali0531-RC/skullcandy-hq-linux/main/udev/99-skullcandy.rules -o /etc/udev/rules.d/99-skullcandy.rules\n sudo udevadm control --reload-rules && sudo udevadm trigger\n\nThis entry drives your SYSTEM Wine (Proton/GE can't do the headset HID).\nThe HID bridge runs as a user service: systemctl --user status hidbridge",
"installer": [
{
"extract": {
"dst": "$CACHE/src",
"file": "bridge"
}
},
{
"execute": {
"command": "bash \"$CACHE/src/install.sh\" --installer \"$setup\"",
"description": "Installing Skull-HQ + native HID bridge (system Wine). Complete any installer prompts that appear.",
"disable_runtime": true
}
}
],
"system": {
"disable_runtime": true
}
}
}