{"id":19158335,"url":"https://github.com/zebradil/powerline-taskwarrior","last_synced_at":"2025-04-05T11:07:33.715Z","repository":{"id":10934054,"uuid":"67551506","full_name":"Zebradil/powerline-taskwarrior","owner":"Zebradil","description":"䷡→䷆ A Powerline segment for displaying information from Taskwarrior task manager","archived":false,"fork":false,"pushed_at":"2025-02-26T00:38:28.000Z","size":319,"stargazers_count":70,"open_issues_count":3,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-29T10:06:34.965Z","etag":null,"topics":["powerline","powerline-segment","powerline-taskwarrior","taskwarrior","taskwarrior-segment"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zebradil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["zebradil"],"custom":["https://www.paypal.me/zebradil"]}},"created_at":"2016-09-06T22:30:22.000Z","updated_at":"2025-02-26T00:38:30.000Z","dependencies_parsed_at":"2024-09-09T13:30:34.331Z","dependency_job_id":"124e4c54-023f-498f-b32d-fdf8726e3176","html_url":"https://github.com/Zebradil/powerline-taskwarrior","commit_stats":{"total_commits":131,"total_committers":6,"mean_commits":"21.833333333333332","dds":0.3282442748091603,"last_synced_commit":"47fc7093f3273ff4e61d0eb211650e0e103092d7"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zebradil%2Fpowerline-taskwarrior","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zebradil%2Fpowerline-taskwarrior/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zebradil%2Fpowerline-taskwarrior/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zebradil%2Fpowerline-taskwarrior/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zebradil","download_url":"https://codeload.github.com/Zebradil/powerline-taskwarrior/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325693,"owners_count":20920714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["powerline","powerline-segment","powerline-taskwarrior","taskwarrior","taskwarrior-segment"],"created_at":"2024-11-09T08:43:40.594Z","updated_at":"2025-04-05T11:07:33.688Z","avatar_url":"https://github.com/Zebradil.png","language":"Python","funding_links":["https://github.com/sponsors/zebradil","https://www.paypal.me/zebradil"],"categories":[],"sub_categories":[],"readme":"# Powerline Taskwarrior\n\n![CI](https://github.com/zebradil/powerline-taskwarrior/actions/workflows/ci.yml/badge.svg)\n[![PyPI](https://img.shields.io/pypi/v/powerline-taskwarrior.svg)](https://pypi.python.org/pypi/powerline-taskwarrior)\n[![PyPI](https://img.shields.io/pypi/l/powerline-taskwarrior.svg)](https://opensource.org/licenses/MIT)\n\nA set of [Powerline][1] segments for showing information retrieved from [Taskwarrior][2] task manager.\n\nIt shows a current context and the most urgent active task.\n\n![screenshot][4]\n\n## Requirements\n\nTaskwarrior segments require:\n- [task][2] v2.4.2 or later,\n- Python `^3.7` (support for Python 2.7 was dropped)\n\n## Installation\n\n### AUR\n\n```sh\nyay -S python-powerline-taskwarrior\n```\n\n### PIP\n\n```sh\npip install --user -U powerline-taskwarrior\n```\n\nIt can also be installed system-wide, but this is usually a bad idea.\n\n### Debian\n\nOn Debian (testing or unstable), installation can be performed with apt:\n\n```sh\napt install python-powerline-taskwarrior\n```\n\n## Usage\n\n### Activate segments\n\nTo activate Taskwarrior segments add them to your segment configuration.\nSee more about powerline configuration in [the official documentation][7].\nFor example, I store powerline configuration in\n`~/.config/powerline/themes/shell/default.json`.\n\nThese are available powerline-taskwarrior segments:\n\n- display current context name\n  ```json\n  {\n      \"function\": \"powerline_taskwarrior.context\",\n      \"priority\": 70\n  }\n  ```\n\n- display the count of pending tasks\n  ```json\n  {\n      \"function\": \"powerline_taskwarrior.pending_tasks_count\",\n      \"priority\": 70\n  }\n  ```\n\n- display the most urgent active task\n  ```json\n  {\n      \"function\": \"powerline_taskwarrior.active_task\",\n      \"priority\": 70\n  }\n  ```\n\n- display the most urgent next task\n  ```json\n  {\n      \"function\": \"powerline_taskwarrior.next_task\",\n      \"priority\": 70\n  }\n  ```\n\n- *obsolete* segment displays both of listed above\n  ```json\n  {\n      \"function\": \"powerline_taskwarrior.taskwarrior\",\n      \"priority\": 70\n  }\n  ```\n\n### Color scheme\n\nTaskwarrior-powerline requires custom colorscheme to be configured.\nAdd the following to your colorschemes (`.config/powerline/colorschemes/default.json`):\n\n```json\n{\n  \"groups\": {\n    \"taskwarrior:context\": \"information:regular\",\n    \"taskwarrior:pending_tasks_count\": \"information:priority\",\n    \"taskwarrior:active_id\": { \"bg\": \"mediumgreen\", \"fg\": \"black\", \"attrs\": [] },\n    \"taskwarrior:active_desc\": { \"bg\": \"green\", \"fg\": \"black\", \"attrs\": [] },\n    \"taskwarrior:next_id\": { \"bg\": \"brightyellow\", \"fg\": \"black\", \"attrs\": [] },\n    \"taskwarrior:next_desc\": { \"bg\": \"yellow\", \"fg\": \"black\", \"attrs\": [] }\n  }\n}\n\n```\n\nAnd here you can configure the colors.\n\nSee [powerline colorschemes docs][6] for more details.\n\n### Further customization\n\nIf you have a custom name for `task` command, it should be specified via `task_alias` argument in the segment configuration.\n\n`powerline_taskwarrior.active_task` and `powerline_taskwarrior.next_task` segments accept `description_length` parameter.\nIt is an integer which represents a maximum length of the description field.\nIf a description is longer than `description_length`, it is truncated by words.\n\n`powerline_taskwarrior.next_task` segment accepts `ignore_active` parameter.\nIf it set to `true`, the segment will be shown always, regardless of existence of an active task.\n\n```json\n{\n    \"function\": \"powerline_taskwarrior.next_task\",\n    \"priority\": 70,\n    \"args\": {\n        \"task_alias\": \"taskwarrior\",\n        \"description_length\": 40\n    }\n}\n```\n\n\n## License\n\nLicensed under [the MIT License][5].\n\nBy [German Lashevich][3].\n\n[1]: https://powerline.readthedocs.org/en/master/\n[2]: http://taskwarrior.org/\n[3]: https://github.com/zebradil\n[4]: https://github.com/zebradil/powerline-taskwarrior/blob/master/screenshot.png\n[5]: https://github.com/zebradil/powerline-taskwarrior/blob/master/LICENSE\n[6]: http://powerline.readthedocs.io/en/master/configuration/reference.html#colorschemes\n[7]: https://powerline.readthedocs.io/en/master/configuration.html#configuration-and-customization\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebradil%2Fpowerline-taskwarrior","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzebradil%2Fpowerline-taskwarrior","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebradil%2Fpowerline-taskwarrior/lists"}