FAQ

FAQ

Does it work on Wayland?

Currently X11 only (xdotool/xprop). Wayland support is planned for a future phase.

How much disk space does it use?

About 5MB per day of activity in SQLite. A full year ≈ 2GB.

Can it track multiple monitors?

Yes — it tracks the active/focused window regardless of which monitor it's on.

Does it capture what's on my screen?

No. It only captures the window title and app name. Never screenshots, never page content.

What if I forget to start it?

Add it to autostart: systemctl --user enable taskmind. It will start on login.

Can I exclude sensitive apps?

Yes. Add app names to blacklisted_apps in ~/.config/taskmind/config.yaml:

tracking:
  blacklisted_apps: ["1password", "keepassxc", "banking"]

How do I delete all my data?

taskmind stop
rm ~/.local/share/taskmind/taskmind.db

Does it need internet?

No. Everything runs 100% locally. No cloud, no API calls, no telemetry.

Can my team use this?

Yes. Each person installs and runs their own instance. Data stays on their machine. They can export timesheets via CSV.

What Python version do I need?

Python 3.6+ (ships with Ubuntu 18.04+).

Can I use it on macOS/Windows?

Not yet. Linux first. Cross-platform support is planned (Phase 6 in the roadmap).

Does it work on Wayland?

Yes! Since v0.1.1, TaskMind supports GNOME Wayland. The installer auto-installs the required extension. You just need to log out/in once after install.

I see "Unclassified: 0h 53m" but no window titles?

You're likely on Wayland and haven't logged out/in after install. The GNOME extension needs a shell restart to activate. Log out, log back in, then taskmind start.