Skip to content

Add Linux desktop preview with native telemetry and Wayland support - #94

Draft
saadah7 wants to merge 8 commits into
mainfrom
feat/linux-current
Draft

saadah7 wants to merge 8 commits into
mainfrom
feat/linux-current

Conversation

@saadah7

@saadah7 saadah7 commented Oct 30, 2026 •

Copy link
Copy Markdown
Collaborator

Cleanmeter currently ships a Windows-only application. This adds a Linux x86-64 desktop preview on the current v2.2.19 baseline, retaining the shared settings and overlay UI. It supersedes the older implementation in #68.

Changes

  • Native CPU, RAM and network monitoring, available AMD/Intel sysfs and NVIDIA readings, clocks, and supported hwmon/RAPL CPU power.
  • Per-frame MangoHud capture with live 1%/0.1% lows and recording controls, plus a private launcher configuration.
  • Linux autostart, diagnostics and desktop lifecycle; X11/XWayland overlays, layer-shell positioning where supported, and desktop-mediated Wayland shortcuts.
  • AppImage, DEB and RPM packaging, native test harnesses, and signed AppImage draft-release configuration.

The branch separates telemetry/FPS, desktop integration, shared UI, packaging/tests, documentation, and follow-up fixes into logical commits.

Validation

  • 195 frontend tests, ESLint and production build passed.

  • 62 Linux Rust tests and 64 Windows Rust tests passed; each suite has one explicitly ignored live-capture test.

  • Five launcher tests passed.

  • Native X11 tests exercised settings, preferences, startup, overlay visibility, tabs, recording controls and real MangoHud/Vulkan FPS capture.

  • Extracted AppImage through AppRun and installed DEB passed native tests and live FPS capture. DEB replacement/uninstall and isolated RPM payload install/uninstall were checked; RPM checks are not Fedora runtime validation.

  • Headless Sway exercised layer-shell overlay rendering, mixed-scale displays and runtime scale changes. A private portal fixture covered shortcut activation, rebinding and session revocation; actual desktop consent remains unverified.

  • Five standalone TypeScript diagnostics were reproduced on unchanged main. No new typecheck-clean claim is made.

  • Follow-up native tests confirm frozen lows survive game exit and telemetry expiry, and GTK backend lists wayland,x11 and x11,wayland select the correct native Wayland path.

  • Browser checks at 1280, 768 and 375 pixels confirm Pixel Shift is disabled with an explanation when positioning is unavailable, and remains usable on supported platforms.

Remaining work before merge/release

This is a draft desktop preview, not complete Linux or Steam Deck Game Mode support.

  • Implement Game Mode coexistence with Steam's performance HUD and bounded long-session capture; MangoHud currently retains samples throughout logging.
  • Validate physical Deck sensors, Proton, suspend/resume, monitor unplug/replug, performance, and signed update installation. Headless Sway rejected output disabling, so that test does not establish unplug behavior.

The earlier AppImage handed off for Desktop Mode testing predates the follow-up fixes above. No release is published by this PR.

@coderabbitai

coderabbitai Bot commented Oct 30, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant