Deskmeter GNOME Integration

Display your current deskmeter task in the GNOME panel or in a standalone window.

Quick Start

Task Window (No logout required)

# Run the task window with auto port detection
python3 task_window.py

# Make it always-on-top and visible on all workspaces
wmctrl -r "Deskmeter Task" -b add,above,sticky

GNOME Extension (Requires logout)

Extension is already installed and enabled. Just log out and back in to activate it.

# Check status
gnome-extensions list --enabled | grep deskmeter

# View logs after login
journalctl --user -u org.gnome.Shell@wayland.service -f | grep deskmeter

Features

• ✅ Auto port detection - Finds dmweb on ports 10001 or 10000
• ✅ Workspace change detection - Updates when you switch workspaces
• ✅ Error handling - Won't crash GNOME Shell if something fails
• ✅ Minimal UI - Clean display without window decorations

Requirements

• GNOME Shell 49+ (Wayland or X11)
• Python 3 with GTK4 (python3-gi)
• dmweb running on port 10000 or 10001
• wmctrl (for workspace detection and window properties)

Documentation

See docs/ directory for detailed documentation:

• READY_TO_TEST.md - Complete testing guide (START HERE)
• TASK_WINDOW_README.md - Task window usage and configuration
• INSTALL_STATUS.md - Extension installation and troubleshooting
• PORT_DETECTION_README.md - How auto port detection works

Project Structure

dm-gnomeext/
├── task_window.py              # Standalone GTK window app
├── run_task_window.sh          # Helper script for window
├── gnome-extension/            # Extension source
│   └── deskmeter-indicator@local/
│       ├── extension.js
│       ├── metadata.json
│       └── stylesheet.css
├── docs/                       # Documentation
└── README.md                   # This file

Quick Commands

# Test task window
python3 task_window.py

# Test API
curl http://localhost:10001/api/current_task

# Check extension status
gnome-extensions list --enabled | grep deskmeter

# Make window always-on-top
wmctrl -r "Deskmeter Task" -b add,above,sticky

Support

For troubleshooting and detailed information, see the docs/ directory.