# Citizen Launcher 0.9.2

Citizen Launcher is the distro-neutral successor to Omarchy Citizen.

## Goal

**Install Linux → install Citizen Launcher → log into RSI → play.**

The core is one static Go binary and does not depend on Omarchy. Omarchy is an optional integration under `integrations/omarchy/`.

## Supported targets

Primary targets:

- Debian / Ubuntu / Linux Mint
- Fedora
- Arch Linux / Omarchy
- openSUSE (generic user install)

Other amd64 Linux distributions can use the generic tarball when they provide a working Vulkan driver and the runtime requirements of the selected Wine runner.

## GUI

`citizen-launcher gui` starts a localhost-only UI from files embedded in the Go binary. Chromium-family browsers open it as a dedicated app window; otherwise it opens in the default browser. No GTK/Qt/WebKit development/runtime package is required by Citizen Launcher itself.

## Architecture

```text
Standalone GUI / Omarchy bar integration
                 ↓
           Citizen Launcher
             Go core
                 ↓
 ┌───────────────┼────────────────┐
 Hardware      Wine             RSI Launcher
 readiness     selector          installer
               + self-test
                 ↓
             Wine prefix
                 ↓
       Winetricks + DXVK
                 ↓
          Star Citizen
```

The managed game stack lives in XDG user directories:

- `~/.config/citizen-launcher`
- `~/.local/share/citizen-launcher`
- `~/.local/state/citizen-launcher`
- `~/.cache/citizen-launcher`

Existing `omarchy-citizen` data is migrated when possible.

## Build

```bash
./build.sh
```

## Install (any desktop distro)

```bash
./install.sh
```

For Omarchy plus bar integration:

```bash
./install-omarchy.sh
```

## Debian package

```bash
./packaging/build-deb.sh
```

## Security boundaries

Citizen Launcher manages its Wine/DXVK/RSI stack entirely as the current user. It does not create passwordless sudo/pacman/apt rules. GPU/kernel/base-system updates remain owned by the distribution.


## 0.9.2 fixes

- PowerShell is no longer a mandatory prefix component.
- RSI `latest.yml` parser accepts Electron Builder `path:` and nested `files: - url:` formats.
- Repair also refreshes DXVK.
- Responsive dashboard prevents long GPU/distribution names from overflowing.
- GUI shows concise user-facing errors with expandable technical details.

## Automatic Citizen Launcher updates

Starting with 0.9.2 the launcher itself is part of Autopilot.

### Debian / Ubuntu / Mint

Installing the `.deb` once enables `citizen-launcher-self-update.timer`. Future
Citizen Launcher releases are checked automatically every six hours. A new `.deb`
is only installed after its GitHub SHA-256 asset digest and Debian package metadata
have been verified.

The currently running GUI is never killed during package replacement. If an update
landed while the GUI was open, the app shows **Neue Version installiert** and offers
a controlled restart into the new binary.

See `packaging/SELF_UPDATE.md` for details.