Skip to content

Boomer42/linux-citizen-plugin

Repository files navigation

Linux Citizen - Star Citizen OpenDeck Plugin (v1.0)

A high-fidelity tactical interface for Star Citizen on Linux (CachyOS, Arch, Ubuntu, Fedora). This plugin allows you to sync in-game keybinds, create complex macros with interactive push animations, and monitor live game telemetry directly on your OpenDeck.

Features

  • 🚀 Citizen Key Bind: Automatically syncs with your actionmaps.xml to keep your deck up to date with in-game changes.
  • ⌨️ Custom Key Bind: Record custom key sequences with a high-fidelity 16-column virtual keyboard.
  • ≡ Macro Group Bind: Build sequences of actions with precision delays and interactive drag-and-drop sorting.
  • 💀 Force Kill Utility: Universal Linux emergency terminator for frozen game processes.
  • 📊 Mission Telemetry: Live HUD displaying CPU load (with system context), RAM usage, Network bandwidth, and Session Uptime.

Installation & Setup

This plugin requires special permissions to simulate key presses on Linux via the uinput module.

1. Granting Access to /dev/uinput

OpenDeck usually runs in a secure sandbox (Flatpak). You must grant it access to the input device:

Using Flatseal (Recommended):

  1. Install Flatseal from your app store or Flathub.
  2. Select OpenDeck (me.amankhanna.opendeck) in the list.
  3. Scroll to Filesystem -> Other files.
  4. Add /dev/uinput and ensure the toggle is ON.

2. Linux User Groups

Ensure your user has permission to use input devices:

sudo usermod -aG input $USER

(You may need to log out and back in for this to take effect.)

3. Global Configuration

Once installed, click the Gear Icon in any action to set the path to your actionmaps.xml. Typical path: .../StarCitizen/LIVE/user/client/0/Profiles/default/actionmaps.xml


Technical Details

  • Backend: Written in Rust using openaction and mouse-keyboard-input.
  • Frontend: HTML5/JS HUD with Star Citizen Navy/Cyan aesthetics.
  • Rendering: Live telemetry buttons are rendered via dynamic SVG-to-Base64 conversion for maximum clarity.

Developed by Boomer42 Fly safe, Citizen.

About

This plugin allows you to sync in-game keybinds, create complex macros with interactive push animations, and monitor live game telemetry directly on your OpenDeck.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors