Desktop shell: questions for Charles (non-blocking; the recommended answers are being built) #837

Open
opened 2026-11-17 23:03:10 +00:00 by charles · 0 comments
Owner

From the spec, §18. Answer here to overrule any of them; until then the recommended choice is what gets built.

  • Q1 — Split. Recommended: sub-project 6 "Desktop shell" (this spec, 44 tasks) and a new
    sub-project 11 "In-game overlay" (§14), with only the overlay spike here. Alternative:
    the overlay inside 6 (about 15 more tasks, and the shell waits for the overlay's manual
    testing).
  • Q2 — Overlay process. Recommended: a thread of the client with its own native window,
    fed in-process by the status payload type. Alternative: a separate flaxative-overlay
    program fed by the status API (survives a client crash, could serve the Electron client
    too; costs a second binary in every package and update).
  • Q3 — Windows key capture. Recommended: low-level hooks, as the original
    (N/windows-input-hook), pass-through. Alternative: Raw Input with RIDEV_INPUTSINK
    (Microsoft's recommendation for monitoring; no hook timeout to be dropped by) — worth
    trying if hooks prove flaky in games; the back-end trait allows both.
  • Q4 — fluxer://. Recommended: always register flaxative://; register fluxer://
    only when nothing else holds it, and accept it on the command line. Alternative: always
    claim fluxer:// (links from the web app open Flaxative even with the Electron client
    installed).
  • Q5 — Autostart default. Recommended: off, with the switch in Desktop settings; a
    nightly-channel client that adds itself to login unasked is a surprise. Alternative: on at
    first run, as the original (feat/platform/utils/Autostart.ts).
  • Q6 — Tray on GNOME without the extension. Recommended: no tray, close quits, the
    settings explain. Alternative: keep running without any surface (reachable only by
    launching again), as some clients do — confusing.
  • Q7 — Companion control. Recommended: add mute / deafen / disconnect ops to the status
    API behind a switch that is off by default, so the MiraboxMixer bridge can drop Chromium
    remote debugging. Alternative: read-only API, the bridge keeps to the Electron client.
  • Q8 — Direct input. Recommended: offer it (opt-in) as the original does; it is the only
    system-wide path on Sway and COSMIC and the dependable push-to-talk on KDE. Alternative:
    leave it out and document "focused only" there.
  • Q9 — Windows shortcuts. Recommended: Start menu and Desktop. Alternative: Start menu
    only (today).
  • Q10 — Close to tray by default. Recommended: on, as the original (a first-time user
    who closes the window stays in voice). Alternative: off, with a one-time hint.
  • Q11 — Tray library on Linux. Recommended: decided by Task 2 — ksni if cargo deny
    accepts Unlicense and the second zbus, else the client's own item over zbus 6.
    Alternative: tray-icon's GTK back end (brings GTK 3 into the AppImage).
  • Q12 — Live testing. Recommended: Charles runs docs/acceptance/shell.md on Windows 11,
    KDE Wayland and one GNOME machine; community testers cover Sway / Hyprland through the
    bug-report forum. Nothing in the build contacts the live server.

19. Sources

Portal: flatpak.github.io/xdg-desktop-portal (GlobalShortcuts, host.portal.Registry,
Background), its NEWS.md (1.19.4 registry, 1.21.0 ConfigureShortcuts);
release.gnome.org/48/developers; wiki.hypr.land (global binds);
github.com/emersion/xdg-desktop-portal-wlr issue 240; pop-os/xdg-desktop-portal-cosmic
cosmic.portal; bugs.kde.org 484525, 483640, 523063. Crates: docs.rs ashpd 0.14, ksni
0.3, tray-icon 0.26 and its changelog, global-hotkey 0.10 (X11 grabs and a 50 ms release
poll on Windows: not used), interprocess. Windows: learn.microsoft.com
(LowLevelKeyboardProc, RegisterHotKey, RAWINPUTDEVICE, CreateNamedPipe, toast
notifications for unpackaged apps), devblogs.microsoft.com/directx "Demystifying Fullscreen
Optimizations", docs.velopack.io (shortcuts, installer). Linux desktop:
specifications.freedesktop.org/autostart; wayland.app (wlr-layer-shell-unstable-v1,
xx-session-management-v1); gitlab.gnome.org/GNOME/mutter issue 973; bugs.kde.org 510544,
367086; ValveSoftware/gamescope steamcompmgr.cpp; github.com/trigg/Discover;
github.com/overlayeddev/overlayed. Discord: discord.com/blog/player-release-q12025 and
"how to use Discord's in-game overlay" (April 2025). winit 0.30.13 and iced 0.14 were read in
the local cargo registry (platform_impl/linux/wayland/window/mod.rs: set_visible,
focus_window, outer_position; iced_runtime/src/window.rs; iced/src/daemon.rs).

From the spec, §18. Answer here to overrule any of them; until then the recommended choice is what gets built. ## 18. Questions for Charles (non-blocking; the recommended choice is what gets built) - **Q1 — Split.** Recommended: sub-project 6 "Desktop shell" (this spec, 44 tasks) and a new **sub-project 11 "In-game overlay"** (§14), with only the overlay spike here. Alternative: the overlay inside 6 (about 15 more tasks, and the shell waits for the overlay's manual testing). - **Q2 — Overlay process.** Recommended: a thread of the client with its own native window, fed in-process by the status payload type. Alternative: a separate `flaxative-overlay` program fed by the status API (survives a client crash, could serve the Electron client too; costs a second binary in every package and update). - **Q3 — Windows key capture.** Recommended: low-level hooks, as the original (`N/windows-input-hook`), pass-through. Alternative: Raw Input with `RIDEV_INPUTSINK` (Microsoft's recommendation for monitoring; no hook timeout to be dropped by) — worth trying if hooks prove flaky in games; the back-end trait allows both. - **Q4 — `fluxer://`.** Recommended: always register `flaxative://`; register `fluxer://` only when nothing else holds it, and accept it on the command line. Alternative: always claim `fluxer://` (links from the web app open Flaxative even with the Electron client installed). - **Q5 — Autostart default.** Recommended: **off**, with the switch in Desktop settings; a nightly-channel client that adds itself to login unasked is a surprise. Alternative: on at first run, as the original (`feat/platform/utils/Autostart.ts`). - **Q6 — Tray on GNOME without the extension.** Recommended: no tray, close quits, the settings explain. Alternative: keep running without any surface (reachable only by launching again), as some clients do — confusing. - **Q7 — Companion control.** Recommended: add mute / deafen / disconnect ops to the status API behind a switch that is off by default, so the MiraboxMixer bridge can drop Chromium remote debugging. Alternative: read-only API, the bridge keeps to the Electron client. - **Q8 — Direct input.** Recommended: offer it (opt-in) as the original does; it is the only system-wide path on Sway and COSMIC and the dependable push-to-talk on KDE. Alternative: leave it out and document "focused only" there. - **Q9 — Windows shortcuts.** Recommended: Start menu and Desktop. Alternative: Start menu only (today). - **Q10 — Close to tray by default.** Recommended: on, as the original (a first-time user who closes the window stays in voice). Alternative: off, with a one-time hint. - **Q11 — Tray library on Linux.** Recommended: decided by Task 2 — `ksni` if `cargo deny` accepts Unlicense and the second zbus, else the client's own item over zbus 6. Alternative: `tray-icon`'s GTK back end (brings GTK 3 into the AppImage). - **Q12 — Live testing.** Recommended: Charles runs `docs/acceptance/shell.md` on Windows 11, KDE Wayland and one GNOME machine; community testers cover Sway / Hyprland through the bug-report forum. Nothing in the build contacts the live server. ## 19. Sources Portal: flatpak.github.io/xdg-desktop-portal (`GlobalShortcuts`, `host.portal.Registry`, `Background`), its `NEWS.md` (1.19.4 registry, 1.21.0 `ConfigureShortcuts`); release.gnome.org/48/developers; wiki.hypr.land (global binds); github.com/emersion/xdg-desktop-portal-wlr issue 240; pop-os/xdg-desktop-portal-cosmic `cosmic.portal`; bugs.kde.org 484525, 483640, 523063. Crates: docs.rs `ashpd` 0.14, `ksni` 0.3, `tray-icon` 0.26 and its changelog, `global-hotkey` 0.10 (X11 grabs and a 50 ms release poll on Windows: not used), `interprocess`. Windows: learn.microsoft.com (`LowLevelKeyboardProc`, `RegisterHotKey`, `RAWINPUTDEVICE`, `CreateNamedPipe`, toast notifications for unpackaged apps), devblogs.microsoft.com/directx "Demystifying Fullscreen Optimizations", docs.velopack.io (shortcuts, installer). Linux desktop: specifications.freedesktop.org/autostart; wayland.app (`wlr-layer-shell-unstable-v1`, `xx-session-management-v1`); gitlab.gnome.org/GNOME/mutter issue 973; bugs.kde.org 510544, 367086; ValveSoftware/gamescope `steamcompmgr.cpp`; github.com/trigg/Discover; github.com/overlayeddev/overlayed. Discord: discord.com/blog/player-release-q12025 and "how to use Discord's in-game overlay" (April 2025). winit 0.30.13 and iced 0.14 were read in the local cargo registry (`platform_impl/linux/wayland/window/mod.rs`: `set_visible`, `focus_window`, `outer_position`; `iced_runtime/src/window.rs`; `iced/src/daemon.rs`).
charles added this to the Desktop shell milestone 2026-11-17 23:03:10 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#837
No description provided.