v3 Roadmap: Cross-platform rewrite discussion

[AreteDriver]

Cross-Platform Rewrite Discussion

The EVE community has shown interest in expanding Argus Overview beyond Linux. Currently v3.0 supports Linux (X11/XWayland) and Windows (Win32 API), but Mac support and a Wayland-native path remain open.

What's on the table

• Mac support — Currently unsupported. Requires a new platform backend
• Wayland native — Pure Wayland's security model blocks window management today. A compositor-specific or portal-based approach could change this
• Single-binary distribution — A compiled language (Rust, Go, C++) would simplify packaging across all platforms

Language options being considered

Language	Pros	Cons
Qt/C++	Closest to current PySide6 arch	C++ complexity, build toolchain
Rust + egui/iced	Performance, safety, single binary	Ecosystem maturity for GUI
Go + Fyne	Simple, fast builds	Less mature GUI ecosystem

How to contribute

If you're interested in working on any aspect of this:

1. Comment here with your platform interest (Mac, Wayland, etc.)
2. Read docs/ARCHITECTURE.md and src/argus_overview/platform/base.py for the abstraction contract
3. See CONTRIBUTING.md "High Impact Contributions" section for detailed guidance
4. Open a separate issue for your specific implementation proposal

Community validation

This roadmap item was surfaced through community discussion. Your +1 and input helps prioritize this work.

---

This is a discussion issue — no commitment to a specific timeline or implementation. The goal is to gather interest and let contributors self-organize around the work.

[AreteDriver]

Wayland POC Shipped (v3.1.0)

A proof-of-concept Wayland platform backend landed in v3.1.0. Here's what's working:

Supported Compositors

• Sway — window enumeration via swaymsg -t get_tree, auto-detected via SWAYSOCK
• Hyprland — window enumeration via hyprctl clients -j, auto-detected via HYPRLAND_INSTANCE_SIGNATURE

Capabilities

Feature	Status	Implementation
Window enumeration	Working	swaymsg / hyprctl
EVE window filtering	Working	Same title regex as X11/Win32
Window capture	Working	grim (region capture)
Screen geometry	Working	wlr-randr parsing
Window move/resize	Stub	Needs compositor IPC
Window activate	Stub	Needs compositor IPC

Architecture

• platform/wayland.py implements all ABCs from platform/base.py
• Factory functions in platform/__init__.py route to Wayland when pure Wayland detected
• XWayland sessions continue using Linux (X11) — no behavior change
• EVE path resolution and hotkey handling delegate to Linux implementations (identical under Proton)
• 74 tests with full mock coverage

Limitations

• GNOME Wayland: No wlr-foreign-toplevel — window enumeration won't work. Would need xdg-desktop-portal integration.
• Window management (move/resize/activate): Stubs returning False. Needs compositor-specific IPC (Sway i3 commands, Hyprland dispatchers).
• Capture: Uses grim subprocess — requires it installed. Future: PipeWire/portal integration.

What's Next

• Implement move_window / activate_window via swaymsg and hyprctl dispatch
• Real-device testing on Sway and Hyprland with EVE under Proton
• Evaluate xdg-desktop-portal for GNOME Wayland support