deskmeter/docs/READY_TO_TEST.md

Ready to Test - Deskmeter Task Display

Date: 2025-12-19 Status: ✅ All updates complete and ready for testing

---

What's Been Updated

1. Task Window (task_window.py) ✅

New Features:

• ✅ No window decorations - Clean minimal window, no title bar or close button
• ✅ Workspace change detection - Updates 2.2s after you switch workspaces
• ✅ Auto port detection - Finds dmweb on port 10001 or 10000 automatically
• ✅ Faster updates - Polls every 500ms to catch changes quickly
• ✅ Smaller window - 400x60px (reduced from 400x80)

How to Close:

• Alt+F4 (keyboard)
• pkill -f task_window.py (command line)
• Kill the terminal where you started it

2. GNOME Extension ✅

New Features:

• ✅ Error handling - Won't crash GNOME Shell if something fails
• ✅ Auto port detection - Same as window, tries 10001 then 10000
• ✅ Safe enable/disable - All operations wrapped in try-catch

Updated files in: ~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/

---

How to Test

Option 1: Test Window Now (No Logout Required)

cd /home/mariano/wdir/dm-gnomeext

# Run the window
python3 task_window.py

Expected behavior:

1. Console shows: Found dmweb API on port 10001
2. Small window appears showing: work/own/deskmeter
3. Window has no title bar (clean, minimal)
4. When you switch workspaces, it updates after ~2 seconds

Make it always-on-top (in another terminal):

wmctrl -r "Deskmeter Task" -b add,above,sticky

Position it where you want (drag with mouse or use wmctrl)

Option 2: Test GNOME Extension (Requires Logout)

# 1. Verify extension is enabled
gnome-extensions list --enabled | grep deskmeter

# 2. Check extension files are updated
ls -la ~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/

# 3. Log out and log back in

# 4. After login, check panel for task indicator (left side)

---

What You'll See

Task Window

┌────────────────────────┐
│  work/own/deskmeter   │
└────────────────────────┘

• No borders, no title bar, just the task text
• Clean minimal display
• Position anywhere, stays on top

GNOME Extension

[Activities] [deskmeter] [detecting...] → [work/own/deskmeter]
             └─ Panel indicator

• Shows in panel (left side)
• "detecting..." while finding port
• Then shows current task

---

Testing Checklist

Window Testing

• Window appears without title bar/decorations
• Shows current task: "work/own/deskmeter"
• Can be moved by dragging
• Can close with Alt+F4
• Updates when you switch workspaces (wait ~2s after switch)
• Can be set always-on-top with wmctrl
• Auto-detects port 10001 (check console output)

Extension Testing (after logout/login)

• Extension shows in panel (left side)
• Shows "detecting..." briefly
• Shows current task after detection
• Updates when switching workspaces (wait ~2s)
• If extension fails, GNOME Shell still works (doesn't crash)
• Can disable extension: gnome-extensions disable deskmeter-indicator@local

---

Troubleshooting

Window shows "offline - dmweb not running"

# Check if dmweb is running
ps aux | grep dmweb

# Check what's on port 10001
curl http://localhost:10001/api/current_task

# Should show: {"task_id":"8f797adb","task_path":"work/own/deskmeter"}

Window doesn't update on workspace change

# Test wmctrl is working
wmctrl -d

# Should show workspaces with * marking current one

Window won't stay on top

# After starting window, in another terminal:
wmctrl -r "Deskmeter Task" -b add,above,sticky

# Verify it worked:
wmctrl -l -x | grep -i deskmeter

Extension doesn't appear in panel after logout/login

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

# Check for errors
journalctl --user -u org.gnome.Shell@wayland.service --since "5 minutes ago" | grep -i deskmeter

# Try manually enabling
gnome-extensions enable deskmeter-indicator@local
# Then logout/login again

Extension shows "detecting..." forever

dmweb is not running on any of the tried ports (10001, 10000). Start dmweb:

cd ~/wdir/dm/dmapp/dmweb  # or wherever your dmweb is
python3 run.py

---

Performance Notes

Task Window

• Checks workspace every 200ms (lightweight wmctrl call)
• Updates task every 500ms when no workspace change
• After workspace change: waits 2200ms before updating (gives dmcore time)
• Minimal CPU usage: ~0.1-0.2%

GNOME Extension

• Only updates on workspace switch + periodic refresh
• Uses debounce delay of 2200ms
• Minimal overhead, integrated with GNOME Shell event loop

---

Commands Quick Reference

# Start task window
cd /home/mariano/wdir/dm-gnomeext
python3 task_window.py

# Make window always-on-top + sticky (all workspaces)
wmctrl -r "Deskmeter Task" -b add,above,sticky

# Position window (example: top-right corner)
wmctrl -r "Deskmeter Task" -e 0,1500,0,400,60

# Close window
pkill -f task_window.py
# OR
Alt+F4 (when window has focus)

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

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

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

---

Next Steps

1. Test the window now - No logout required, immediate feedback
2. When satisfied with window behavior - Log out/in to test extension
3. Choose your preference:
   • Use window for now (quick to start/stop)
   • Use extension after logout (cleaner, integrated into panel)
   • Use both (why not?)

---

File Locations

/home/mariano/wdir/dm-gnomeext/
├── task_window.py                      ← Updated window app
├── run_task_window.sh                  ← Helper script (can also use directly)
├── gnome-extension/
│   └── deskmeter-indicator@local/      ← Source (updated)
│       ├── extension.js                  ✅ Error handling added
│       ├── metadata.json                 ✅ GNOME 49 support
│       └── stylesheet.css
└── ~/.local/share/gnome-shell/extensions/
    └── deskmeter-indicator@local/      ← Installed (updated)
        ├── extension.js                  ✅ Error handling added
        ├── metadata.json                 ✅ GNOME 49 support
        └── stylesheet.css

---

Documentation

• INSTALL_STATUS.md - Extension installation troubleshooting
• PORT_DETECTION_README.md - How auto port detection works
• TASK_WINDOW_README.md - Task window usage guide
• READY_TO_TEST.md - This file

---

Everything is ready! Start with the window test - it's the quickest way to verify everything works.

python3 task_window.py

Then when you're ready, log out/in to test the extension.