Installation

Installation Guide

Prerequisites

• Ubuntu 18.04+ (or any Debian-based Linux with X11)
• Python 3.6+

Steps

1. Clone the repo:

git clone https://github.com/rishapgandhi/taskmind.git
cd taskmind

2. Run the installer:

bash install.sh

This automatically:

• Installs system deps (xdotool, xprintidle, libnotify-bin)
• Creates a Python virtual environment
• Installs the package
• Sets up config files
• Installs a systemd user service

3. Start tracking:

taskmind start

Manual Install (without script)

sudo apt install xdotool xprintidle libnotify-bin
pip install -e .
taskmind start

Uninstall

taskmind stop
systemctl --user disable taskmind
rm -rf ~/.local/share/taskmind ~/.config/taskmind

Verify

taskmind status
# Should show: ● TaskMind: tracking | Today: 0h 0m

Wayland Support (Ubuntu 22.04+)

The installer auto-detects Wayland and installs the required GNOME extension. After install:

1. Log out and log back in (one time only)
2. Run taskmind start

That's it. The extension enables TaskMind to read window titles on GNOME Wayland.

How it works

Display Server	Method	Auto-installed
X11	xdotool + xprop	✅ via apt
Wayland (GNOME)	Window Calls extension + D-Bus	✅ via install.sh