# gamesir-connect-linux — GameSir Connect (Cyclone 2 app and firmware updates) on Linux

> Repackages GameSir's official Windows-only GameSir Connect Electron app to run unmodified on Linux, including controller firmware updates: the vendor's JieLi upgrade DLL runs in a Unicorn x86 emulator with device I/O routed to SG_IO.

- URL: https://blog.seolcu.com/projects/gamesir-connect-linux/
- Status: experimental
- Verified: 2026-11-09 — Summary checked against the repository README on 2026-11-09. Tested environments are those the README states.
- Applies to: device GameSir Cyclone 2 (USB 3537:100b and related IDs); needs curl, 7z, unzip, node, npm, openssl, python3; a udev rule (70-gamesir.rules)
- Repository: https://github.com/seolcu/gamesir-connect-linux
- License: MIT
- Search terms: `GameSir Connect Linux`, `GameSir Cyclone 2 Linux firmware update`, `3537:100b`, `JieLi firmware upgrade Linux`
- Last changed: 2026-11-09

## What it does

`build.sh` downloads the official installer (verified against the sha512 in GameSir's `latest.yml`) and converts it on your machine. The repository contains no GameSir code.

| Part | How it is handled |
|---|---|
| Runtime | Same Electron as the original, 13.6.9 linux-x64 (sha256 verified) |
| node-hid | Official N-API prebuild, hidraw backend |
| usb-detection | JS replacement polling `/sys/bus/usb` (the prebuild has symbol mismatches with Electron 13.6.9) |
| ffi-napi | Stubbed (only used for Windows DLLs; segfaults against system libffi) |
| Firmware | Official `jl_firmware_upgrade_x86.dll` emulated with Unicorn; SCSI commands go to `SG_IO` |

## Install

```bash
./build.sh
sudo install -m644 70-gamesir.rules /etc/udev/rules.d/ \
  && sudo udevadm control --reload-rules && sudo udevadm trigger
gamesir-connect
```

Run `./build.sh` again when a new version is released; the app's built-in auto-update is disabled. Not affiliated with GameSir.

## Author and support

Built and maintained by Gyuwon Seol (seolcu). If this project helped you, you can star it at https://github.com/seolcu/gamesir-connect-linux or sponsor the work at https://github.com/sponsors/seolcu.
Source: https://blog.seolcu.com/projects/gamesir-connect-linux/ (content CC BY 4.0)