Files
omarchy-sc/README.md
T
2026-08-31 12:30:29 +02:00

1.9 KiB

Omarchy Citizen 0.6.0

A plug-and-play Star Citizen control panel for Omarchy.

Design goal

Play Star Citizen, don't administer Linux.

The default UI deliberately exposes only:

  • Setup / Start
  • Guided repair
  • Create support bundle

Advanced Wine/DXVK/LUG/NGL controls remain available behind an advanced section.

0.6.0 highlights

  • one primary action that adapts to current system state
  • guided first-time setup
  • symptom-based repair assistant
  • persistent plugin debug log
  • one-click sanitized support bundle
  • support ID for remote troubleshooting
  • Omarchy's native omarchy debug --no-sudo --print included in support bundles
  • advanced controls hidden by default
  • optional NGL remains isolated from the normal launcher path
  • Go-based plugin update backend with Git remote pinning
  • optional automatic updates via systemd user timer
  • updater status/log included in support bundles

Local debug log

~/.local/state/omarchy-citizen/omarchy-citizen.log

The log rotates automatically at roughly 4 MiB and keeps the newest ~2 MiB.

Support bundle

One click creates:

~/Downloads/Omarchy-Citizen-Support-<support-id>.tar.gz

The exported data is sanitized on a best-effort basis before packaging.

See INSTALLATION.md for details.

License

MIT.

Go update backend

The bundled static Go binary lives at:

backend/bin/omarchy-citizen-backend

For Git-managed Omarchy installations it checks the checkout and delegates actual updates to Omarchy's native omarchy plugin update local.omarchy-citizen --yes. Automatic updates are opt-in and run through a systemd user timer roughly every six hours. The Git origin present when auto-update is enabled is pinned as the trusted remote; unattended updates stop if that remote changes or the checkout is dirty.

See backend/README.md and GIT_DISTRIBUTION.md.