Task Coach - Your friendly task manager

Task Coach is a simple open source todo manager to keep track of personal tasks and todo lists.

Quick Start

Download the package for your system from the latest release:

Platform	Package
Debian 12 (Bookworm)	taskcoach_1.6.1.74_debian-12-bookworm.deb
Debian 13 (Trixie)	taskcoach_1.6.1.74_debian-13-trixie.deb
Debian Sid	taskcoach_1.6.1.74_debian-sid.deb
Ubuntu 22.04 (Jammy)	taskcoach_1.6.1.74_ubuntu-22.04-jammy.deb
Ubuntu 24.04 (Noble)	taskcoach_1.6.1.74_ubuntu-24.04-noble.deb
Linux Mint	Use Ubuntu .deb (Mint is Ubuntu-based)
Arch Linux / Manjaro	taskcoach-1.6.1.74-arch.pkg.tar.zst
Fedora 39/40	taskcoach-1.6.1.74-fedora39.noarch.rpm
Any Linux (x86_64)	TaskCoach-1.6.1.74-x86_64.AppImage

Example: Install on Debian/Ubuntu

cd ~/Downloads
wget https://github.com/realcarbonneau/taskcoach/releases/latest/download/taskcoach_1.6.1.74_debian-13-trixie.deb
sudo apt install ./taskcoach_1.6.1.74_debian-13-trixie.deb
taskcoach.py

Or launch from Applications → Office → Task Coach.

To uninstall:

sudo apt remove taskcoach
sudo apt autoremove  # optional: remove unused dependencies

Example: Install on Arch Linux / Manjaro

cd ~/Downloads
wget https://github.com/realcarbonneau/taskcoach/releases/latest/download/taskcoach-1.6.1.74-arch.pkg.tar.zst
sudo pacman -U taskcoach-1.6.1.74-arch.pkg.tar.zst
taskcoach.py

To uninstall:

sudo pacman -R taskcoach
sudo pacman -Qdtq | sudo pacman -Rs -  # optional: remove orphaned dependencies

Example: Install on Fedora

cd ~/Downloads
wget https://github.com/realcarbonneau/taskcoach/releases/latest/download/taskcoach-1.6.1.74-fedora40.noarch.rpm
sudo dnf install ./taskcoach-1.6.1.74-fedora40.noarch.rpm
taskcoach.py

To uninstall:

sudo dnf remove taskcoach
sudo dnf autoremove  # optional: remove unused dependencies

Or run the AppImage (any Linux, no install needed)

cd ~/Downloads
wget https://github.com/realcarbonneau/taskcoach/releases/latest/download/TaskCoach-1.6.1.74-x86_64.AppImage
chmod +x TaskCoach-1.6.1.74-x86_64.AppImage
./TaskCoach-1.6.1.74-x86_64.AppImage

To remove: simply delete the AppImage file.

Running from Source

For development or if you prefer running from git:

git clone --depth 1 https://github.com/realcarbonneau/taskcoach.git
cd taskcoach
./setup.sh
./taskcoach-run.sh

See docs/DEBIAN_BOOKWORM_SETUP.md for detailed setup options, troubleshooting, and platform-specific instructions.

Testing

Quick sanity check to verify the installation:

./test_taskcoach.sh

This tests Python version, dependencies, module imports, and wxPython patch status.

License

Task Coach is free software licensed under the GNU General Public License v3.

Copyright (C) 2004-2016 Task Coach developers

Architecture Overview

Task Coach is a desktop application developed in Python using wxPython for its GUI. It follows the Model-View-Controller pattern with three main layers:

• Domain layer: Classes for tasks, categories, effort, notes and other domain objects
• GUI layer: Viewers, controllers, dialogs, menus and other GUI components
• Persistence layer: Loading/saving domain objects to XML files (.tsk) and exporting to various formats

Source Code Overview

Key packages:

Package	Description
domain	Domain objects (tasks, categories, effort, notes)
gui	Viewers, dialogs, and UI components
command	Undo/redo-capable user actions (Command pattern)
config	User settings and TaskCoach.ini handling
persistence	.tsk file format (XML) and export functionality
i18n	Internationalization and translations
widgets	Adapted wxPython widgets

Documentation

• DEBIAN_BOOKWORM_SETUP.md - Detailed installation and setup
• PACKAGING.md - Building .deb packages
• CRITICAL_WXPYTHON_PATCH.md - wxPython compatibility patch details

Support

• GitHub Issues: https://github.com/realcarbonneau/taskcoach/issues