{"id":34873967,"url":"https://github.com/taskcoach/taskcoach","last_synced_at":"2026-03-09T06:02:25.457Z","repository":{"id":239393408,"uuid":"799099330","full_name":"taskcoach/taskcoach","owner":"taskcoach","description":"Task Coach is a free, open-source task manager for organizing projects, tracking time, managing recurring tasks, and planning with due dates and reminders. Break down projects into subtasks, categorize and filter tasks, attach notes and files, and visualize your work in list, tree, calendar, or timeline views. Cross-platform desktop app.","archived":false,"fork":false,"pushed_at":"2026-03-03T16:07:42.000Z","size":589883,"stargazers_count":22,"open_issues_count":86,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-03-03T20:39:20.568Z","etag":null,"topics":["cross-platform","desktop-app","gtd","linux","macos","open-source","productivity","project-management","python","python3","task-manager","time-tracking","todo-app","windows","wxpython"],"latest_commit_sha":null,"homepage":"https://github.com/taskcoach/taskcoach","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"vkucera/task-coach","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taskcoach.png","metadata":{"files":{"readme":"README.md","changelog":"changes.in/changes.py","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT.txt","agents":null,"dco":null,"cla":null}},"created_at":"2024-05-11T07:17:09.000Z","updated_at":"2026-03-02T20:55:40.000Z","dependencies_parsed_at":"2026-01-15T00:06:59.866Z","dependency_job_id":"e269a676-c60b-48e5-9ea1-c77eb656acc3","html_url":"https://github.com/taskcoach/taskcoach","commit_stats":null,"previous_names":["starofrainnight/task-coach-ex","taskcoach/taskcoach"],"tags_count":97,"template":false,"template_full_name":null,"purl":"pkg:github/taskcoach/taskcoach","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taskcoach%2Ftaskcoach","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taskcoach%2Ftaskcoach/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taskcoach%2Ftaskcoach/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taskcoach%2Ftaskcoach/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taskcoach","download_url":"https://codeload.github.com/taskcoach/taskcoach/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taskcoach%2Ftaskcoach/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30284629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cross-platform","desktop-app","gtd","linux","macos","open-source","productivity","project-management","python","python3","task-manager","time-tracking","todo-app","windows","wxpython"],"created_at":"2025-12-26T00:30:54.287Z","updated_at":"2026-03-09T06:02:25.433Z","avatar_url":"https://github.com/taskcoach.png","language":"Python","readme":"# Task Coach - Your friendly task manager\n\n![Task Coach](icon%20ideas/splash-modernize/splash_new3a.jpg)\n\nTask Coach is a free/libre/open task manager for keeping track of projects and todo lists.\n\nIt's over 20 years old, and development was stagnant in recent years. Here, the project is continued again and has been updated to Python3!\n\n## Screenshots\n\n![Task Coach main window with task list and editors](docs/images/App%20Screenshot%201.png)\n\n![Task Coach with Task Edit Tabbed Window](docs/images/App%20Screenshot%202.png)\n\n## Quick Start\n\nDownload the package for your system from the [latest release](https://github.com/taskcoach/taskcoach/releases):\n\n| Platform | Package |\n|----------|---------|\n| [Any Linux (x86_64)](#appimage) | `TaskCoach-2.0.2.6-x86_64.AppImage` |\n| [Arch Linux / Manjaro](#arch-linux--manjaro) | `taskcoach-2.0.2.6-arch.pkg.tar.zst` |\n| [Debian 12 (Bookworm)](#debian--ubuntu) | `taskcoach_2.0.2.6_debian-12-bookworm.deb` |\n| [Debian 13 (Trixie)](#debian--ubuntu) | `taskcoach_2.0.2.6_debian-13-trixie.deb` |\n| [Debian Sid](#debian--ubuntu) | `taskcoach_2.0.2.6_debian-sid.deb` |\n| [Fedora 42/43](#fedora) | `taskcoach-2.0.2.6-fedora43.rpm` |\n| [Linux Mint](#debian--ubuntu) | Use Ubuntu `.deb` (Mint is Ubuntu-based) |\n| [macOS (Apple Silicon)](#macos) | `TaskCoach-2.0.2.6-macos-arm64.dmg` |\n| [macOS (Intel)](#macos) | `TaskCoach-2.0.2.6-macos-intel.dmg` |\n| [Ubuntu 22.04 (Jammy)](#debian--ubuntu) | `taskcoach_2.0.2.6_ubuntu-22.04-jammy.deb` |\n| [Ubuntu 24.04 (Noble)](#debian--ubuntu) | `taskcoach_2.0.2.6_ubuntu-24.04-noble.deb` |\n| [Windows](#windows) | `TaskCoach-2.0.2.6-windows-x64-setup.exe` |\n| [Windows (portable)](#windows) | `TaskCoach-2.0.2.6-windows-x64-portable.zip` |\n\nAfter installing, Task Coach should be in normal system launchers (Applications → Office → Task Coach). For CLI, the launch command is `taskcoach.py`.\n\n### Linux\n\n#### Debian / Ubuntu\n\nInstall instructions for Debian Trixie (similar for other Debian/Ubuntu systems, just use the appropriate .deb file):\n\n```bash\ncd ~/Downloads\nwget https://github.com/taskcoach/taskcoach/releases/latest/download/taskcoach_2.0.2.6_debian-13-trixie.deb\nsudo apt install ./taskcoach_2.0.2.6_debian-13-trixie.deb\n```\n\nTo uninstall:\n```bash\nsudo apt remove taskcoach\nsudo apt autoremove  # optional: remove unused dependencies\n```\n\n#### Arch Linux / Manjaro\n\n```bash\ncd ~/Downloads\nwget https://github.com/taskcoach/taskcoach/releases/latest/download/taskcoach-2.0.2.6-arch.pkg.tar.zst\nsudo pacman -U taskcoach-2.0.2.6-arch.pkg.tar.zst\n```\n\nTo uninstall:\n```bash\nsudo pacman -R taskcoach\nsudo pacman -Qdtq | sudo pacman -Rs -  # optional: remove orphaned dependencies\n```\n\n#### Fedora\n\n```bash\ncd ~/Downloads\nwget https://github.com/taskcoach/taskcoach/releases/latest/download/taskcoach-2.0.2.6-fedora43.rpm\nsudo dnf install ./taskcoach-2.0.2.6-fedora43.rpm\n```\n\nTo uninstall:\n```bash\nsudo dnf remove taskcoach\nsudo dnf autoremove  # optional: remove unused dependencies\n```\n\n#### AppImage\n\nRun on any Linux without installation:\n\n```bash\ncd ~/Downloads\nwget https://github.com/taskcoach/taskcoach/releases/latest/download/TaskCoach-2.0.2.6-x86_64.AppImage\nchmod +x TaskCoach-2.0.2.6-x86_64.AppImage\n```\n\nTo launch the AppImage, open the file or run:\n```\n./TaskCoach-2.0.2.6-x86_64.AppImage\n```\n\nTo remove: simply delete the AppImage file.\n\n#### Linux System Tray\n\nTask Coach uses libayatana-appindicator for the system tray icon on Linux. This provides consistent behavior across all desktop environments (KDE, XFCE, MATE, LXQt, LXDE, Cinnamon) and works on both X11 and Wayland.\n\nThe package is installed automatically with the .deb/.rpm packages. For manual installation:\n\n```bash\n# Debian/Ubuntu\nsudo apt install gir1.2-ayatanaappindicator3-0.1\n\n# Fedora\nsudo dnf install libayatana-appindicator-gtk3\n\n# Arch Linux\nsudo pacman -S libayatana-appindicator\n```\n\n**Note:** GNOME Shell removed built-in system tray support. GNOME users need the [AppIndicator Support](https://extensions.gnome.org/extension/615/appindicator-support/) extension to see tray icons. Ubuntu pre-installs this extension.\n\n### macOS\n\nDownload the `.dmg` for your Mac (Apple Silicon for M1/M2/M3/M4, Intel for older Macs). Open the DMG and drag Task Coach to Applications.\n\nOn first launch, macOS will block the app because it's not notarized. Open **System Settings → Privacy \u0026 Security**, scroll down, and click **\"Open Anyway\"** next to the Task Coach message.\n\nSee [README_INSTALL_MACOS.md](README_INSTALL_MACOS.md) for detailed instructions with screenshots.\n\n### Windows\n\nDownload the `.exe` installer and run it. Windows will show a security warning because the app is not signed with a Microsoft certificate. Click **\"More info\"** then **\"Run anyway\"** to proceed.\n\nFor the portable version, extract the `.zip` and run `TaskCoach.bat` from the folder (or `TaskCoach.vbs` for silent launch without a console window).\n\nSee [README_INSTALL_WINDOWS.md](README_INSTALL_WINDOWS.md) for detailed instructions with screenshots.\n\n## Running from Source\n\nFor development or if you prefer running from git:\n\n```bash\ngit clone --depth 1 https://github.com/taskcoach/taskcoach.git\ncd taskcoach\n./setup.sh\n./taskcoach-run.sh\n```\n\nSee [docs/DEBIAN_BOOKWORM_SETUP.md](docs/DEBIAN_BOOKWORM_SETUP.md) for detailed setup options, troubleshooting, and platform-specific instructions.\n\n### Testing after git installaion\n\nQuick sanity check to verify the installation:\n\n```bash\n./test_taskcoach.sh\n```\n\nThis tests Python version, dependencies, module imports, and wxPython patch status.\n\n## License\n\nTask Coach is free software licensed under the [GNU General Public License v3](https://www.gnu.org/licenses/gpl-3.0.html).\n\nCopyright (C) 2004-2026 Task Coach developers\n\n## Architecture Overview\n\nTask Coach is a desktop application developed in Python using wxPython for its GUI. It follows the Model-View-Controller pattern with three main layers:\n\n- **Domain layer**: Classes for tasks, categories, effort, notes and other domain objects\n- **GUI layer**: Viewers, controllers, dialogs, menus and other GUI components\n- **Persistence layer**: Loading/saving domain objects to XML files (.tsk) and exporting to various formats\n\n## Source Code Overview\n\nKey packages:\n\n| Package | Description |\n|---------|-------------|\n| `domain` | Domain objects (tasks, categories, effort, notes) |\n| `gui` | Viewers, dialogs, and UI components |\n| `command` | Undo/redo-capable user actions (Command pattern) |\n| `config` | User settings and TaskCoach.ini handling |\n| `persistence` | .tsk file format (XML) and export functionality |\n| `i18n` | Internationalization and translations |\n| `widgets` | Adapted wxPython widgets |\n\n## Documentation\n\n- [README_INSTALL_MACOS.md](README_INSTALL_MACOS.md) - macOS installation with security bypass\n- [README_INSTALL_WINDOWS.md](README_INSTALL_WINDOWS.md) - Windows installation with SmartScreen bypass\n- [DEBIAN_BOOKWORM_SETUP.md](docs/DEBIAN_BOOKWORM_SETUP.md) - Detailed installation and setup\n- [PACKAGING.md](docs/PACKAGING.md) - Building .deb packages\n- [CRITICAL_WXPYTHON_PATCH.md](docs/CRITICAL_WXPYTHON_PATCH.md) - wxPython compatibility patch details\n\n## Support\n\n- Report bugs or request features at GitHub Issues: https://github.com/taskcoach/taskcoach/issues\n- Ask for help or have other open discussion at https://github.com/orgs/taskcoach/discussions\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaskcoach%2Ftaskcoach","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaskcoach%2Ftaskcoach","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaskcoach%2Ftaskcoach/lists"}