trayscope 0.3.3

System tray application for managing gamescope

Trayscope

A system tray application for managing gamescope, the SteamOS session compositing window manager.

Uses StatusNotifier D-Bus protocol for native Wayland support with waybar and other StatusNotifier-compatible bars.

Features

• System tray integration: Start/stop gamescope from your desktop's system tray (waybar, KDE, etc.)
• Pure Python: No GTK/Qt dependencies, just D-Bus
• Tray menu controls: Configure resolution, refresh rate, filter, backend, and toggles directly from the tray menu
• Single instance: D-Bus name ownership prevents duplicate instances
• Configurable: Settings saved to ~/.config/trayscope/config.json

Installation

pip install . installs Python dependencies (including dbus-next).

pip install .

Usage

trayscope

The app will appear in your system tray (waybar tray module, KDE system tray, etc.).

Configuration

Settings are saved to ~/.config/trayscope/config.json:

{
  "render_width": 1920,
  "render_height": 1080,
  "output_width": 0,
  "output_height": 0,
  "refresh_rate": 60,
  "filter": "fsr",
  "fullscreen": true,
  "backend": "wayland",
  "force_grab_cursor": true,
  "hdr_enabled": false,
  "adaptive_sync": false,
  "gamescope_command": "",
  "extra_args": "",
  "autostart": false
}

Most settings can be changed via the tray menu. Additional notes:

• output_width/output_height: Set to 0 for native resolution (config-only)
• gamescope_command: Custom gamescope command, e.g. flatpak run sh.ironforge.gamescope (config-only)
• extra_args: Additional gamescope arguments (config-only)
• autostart: Start gamescope automatically when trayscope launches

Requirements

• Python 3.10+
• dbus-next
• A StatusNotifier-compatible system tray (waybar, KDE Plasma, GNOME with AppIndicator extension)
• gamescope (must be installed separately)

License

BSD 2-Clause License. See LICENSE for details.

Copyright (c) 2025, Omnimodular AB