feat(linux): install artifacts and docs

[cserby]

Summary

• packaging/linux/udev/70-openlogi.rules — TAG+="uaccess" for Logitech hidraw nodes and uinput; no group membership required on systemd-logind systems. Includes non-systemd GROUP="input" fallback instructions in comments.
• packaging/linux/systemd/openlogi-agent.service — packaged user-unit template for /usr/lib/systemd/user/; complements the per-user unit written by the launch_at_login setting.
• packaging/linux/desktop/openlogi.desktop — XDG application launcher entry.
• packaging/linux/install.sh / uninstall.sh — POSIX sh, set -eu; copies binaries and all artifacts to system paths, reloads udevadm, and performs best-effort icon cache and desktop database updates.
• docs/INSTALL-linux.md — full Linux install guide: prerequisites, build from source, udev rules (uaccess + non-systemd fallback), install.sh usage, autostart via systemctl, verification steps, known limitations.
• README.md — Linux subsection under ## Install with the quick-start snippet and a link to the full guide.

Test plan

• desktop-file-validate packaging/linux/desktop/openlogi.desktop — clean
• shellcheck packaging/linux/install.sh packaging/linux/uninstall.sh — clean (requires shellcheck)
• udevadm verify packaging/linux/udev/70-openlogi.rules — clean (requires udevadm ≥ 252)
• bash -n packaging/linux/install.sh && bash -n packaging/linux/uninstall.sh — no syntax errors
• Full install.sh run after cargo build --release — binaries, rules, unit, desktop, icon all land in expected paths
• udevadm trigger after install — /dev/uinput and /dev/hidraw* become accessible without sudo
• uninstall.sh — all installed files removed, udevadm reloaded

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR extends OpenLogi with full Linux packaging support: udev rules, a systemd user-unit template, a .desktop entry, POSIX install/uninstall scripts, a comprehensive install guide, and the Rust-side permission-probing and launch_at_login systemd reconciliation that backs the GUI's Permissions settings page.

• packaging/linux/: install.sh / uninstall.sh with set -eu, @BINDIR@-substituted service template, XDG desktop entry, and udev rules using TAG+="uaccess" for group-free seat-user access; the previous review's XDG_RUNTIME_DIR issues are addressed in both scripts.
• Rust crates: reconcile_linux writes/removes a per-user systemd unit keyed to current_exe(); probe_uinput / probe_logitech_hidraw check device-file access and surface a live Granted/Denied/Unknown badge in the settings window; the Permission enum and status_badge are appropriately platform-gated.
• Docs + locales: docs/INSTALL-linux.md covers prerequisites through known limitations; "Input device access" key added to all 23 locale files (most still carry the English fallback — translations can follow).

Confidence Score: 5/5

Safe to merge; the install/uninstall scripts, Rust permission probing, and systemd reconciliation are all well-structured and the prior review concerns have been addressed.

All changes are additive Linux-only infrastructure. The Rust paths code, probing logic, and shell scripts follow set -eu and handle errors gracefully. The escape_systemd_exec backslash omission and the dead inner cfg blocks are minor cleanup items that do not affect correctness in any realistic deployment.

crates/openlogi-agent/src/launch_agent.rs — the escape_systemd_exec backslash fix and crates/openlogi-gui/src/windows/settings.rs dead-code cleanup are worth landing before the first Linux release.

Important Files Changed

Filename	Overview
crates/openlogi-agent/src/launch_agent.rs	Adds Linux systemd user-unit reconciliation (write/enable/disable/remove); escape_systemd_exec handles % and $ correctly but does not escape backslashes, which would corrupt the unit's ExecStart if the binary path ever contained one.
crates/openlogi-gui/src/platform/permissions.rs	Adds Linux permission probing via /dev/uinput and /sys/class/hidraw/*/uevent; classification logic is clean and unit-tested.
crates/openlogi-gui/src/windows/settings.rs	Platform-gates the permissions page; permission_field is marked #[cfg(target_os = "macos")] at the function level but still contains dead inner #[cfg] blocks that can never execute.
packaging/linux/install.sh	POSIX sh with set -eu; handles prefix substitution, binary check, udev reload, systemd unit template expansion with metacharacter-safe sed escaping, and best-effort icon/desktop-db updates.
packaging/linux/uninstall.sh	Addresses previous review's XDG_RUNTIME_DIR issue; correctly sets it before sudo -u systemctl call, and triggers udev after rule removal.
packaging/linux/systemd/openlogi-agent.service	Template now uses @bindir@ placeholder substituted by install.sh, resolving the prior ExecStart path mismatch finding.
packaging/linux/udev/70-openlogi.rules	Switches from KERNEL=="hidraw*" to the more precise SUBSYSTEM=="hidraw"; drops the redundant MODE="0660" on systemd-logind systems; correct Bluetooth KERNELS match for uppercase VID.
docs/INSTALL-linux.md	Comprehensive guide covering prerequisites, build, udev (uaccess + non-systemd fallback), install script, autostart, verification, and known limitations.
crates/openlogi-core/src/paths.rs	Adds xdg_config_home() as a public helper that honours an absolute $XDG_CONFIG_HOME and falls back to ~/.config; refactors config_dir() to call it.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    subgraph install["install.sh (system-wide)"]
        A[cargo build --release] --> B[install binaries to PREFIX/bin]
        B --> C[install udev rules to /etc/udev/rules.d/]
        C --> D[udevadm reload + trigger]
        D --> E[expand @BINDIR@ in service template]
        E --> F[write /usr/lib/systemd/user/openlogi-agent.service]
        F --> G[systemctl --user daemon-reload]
    end

    subgraph gui["GUI — launch_at_login toggle"]
        H[reconcile_linux enabled=true] --> I[current_exe path]
        I --> J[render_unit + escape_systemd_exec]
        J --> K[write ~/.config/systemd/user/openlogi-agent.service]
        K --> L[systemctl --user daemon-reload]
        L --> M[systemctl --user enable]
    end

    subgraph perm["GUI — Permissions page"]
        N[probe_uinput: open /dev/uinput write] --> P{classify}
        O[probe_logitech_hidraw: read /sys uevent] --> P
        P -->|Granted| Q[green badge]
        P -->|Denied| R[amber badge + install hint]
        P -->|Unknown| S[amber badge + connect hint]
    end

    subgraph udev["udev rules"]
        T["SUBSYSTEM==hidraw + ATTRS idVendor ==046d → TAG+=uaccess"]
        U["KERNELS==*:046D:* → TAG+=uaccess (BT/uhid)"]
        V["KERNEL==uinput → TAG+=uaccess + static_node"]
    end

Loading

_{Reviews (16): Last reviewed commit: "docs(linux): note replug requirement whe..." | Re-trigger Greptile}

[recchia]

Nice to see the packaging come together — and thanks for carrying the Bluetooth/uhid matcher forward into the comment block; generalizing it to :046D: is a good call.
One thing I'd flag: this adds packaging/linux/udev/70-openlogi.rules as a new file, but udev/70-openlogi.rules already exists in master and neither this PR nor #179 removes it. If both land as-is, the tree ends up with two copies of the rules that will drift apart on the next fix. Suggest making this a git mv of the existing file into packaging/linux/udev/ so there's a single source of truth.

[cserby]

Nice to see the packaging come together — and thanks for carrying the Bluetooth/uhid matcher forward into the comment block; generalizing it to :046D: is a good call. One thing I'd flag: this adds packaging/linux/udev/70-openlogi.rules as a new file, but udev/70-openlogi.rules already exists in master and neither this PR nor #179 removes it. If both land as-is, the tree ends up with two copies of the rules that will drift apart on the next fix. Suggest making this a git mv of the existing file into packaging/linux/udev/ so there's a single source of truth.

Thank you @recchia for pointing this out, I was not aware of your work in the area being merged upstream.

[recchia]

Confirmed on the new push — single source of truth restored, and the rewritten rules look good (generalizing the Bluetooth matcher to :046D: covers more transports than my original). One small thing from my hardware testing that got lost in the rewrite, in case it's worth a line in INSTALL-linux.md: on my setup (Bolt receiver and Bluetooth-direct), already-connected devices needed a replug/power-cycle after installing the rules before the uaccess ACL applied — udevadm trigger alone didn't re-grant it on the existing hidraw nodes. Since install.sh will mostly run with the device already connected, a one-line note could save some "rules don't work" reports. Resolving this thread — thanks for the quick turnaround on the relocation.