{"id":21690514,"url":"https://github.com/aesophor/py-todo","last_synced_at":"2025-04-12T09:40:50.624Z","repository":{"id":55027161,"uuid":"154024184","full_name":"aesophor/py-todo","owner":"aesophor","description":"📋 Lightweight reminder / todo-list in cli","archived":false,"fork":false,"pushed_at":"2022-09-25T01:43:33.000Z","size":153,"stargazers_count":108,"open_issues_count":2,"forks_count":22,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-06T16:50:38.077Z","etag":null,"topics":["cli","python","todo","todolist"],"latest_commit_sha":null,"homepage":"https://www.reddit.com/r/unixporn/comments/9qy35q/oc_pytodo_a_lightweight_reminder_in_cli/","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/aesophor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-21T15:39:02.000Z","updated_at":"2025-03-28T10:36:02.000Z","dependencies_parsed_at":"2023-01-18T21:45:51.162Z","dependency_job_id":null,"html_url":"https://github.com/aesophor/py-todo","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fpy-todo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fpy-todo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fpy-todo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aesophor%2Fpy-todo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aesophor","download_url":"https://codeload.github.com/aesophor/py-todo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248548990,"owners_count":21122808,"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":["cli","python","todo","todolist"],"created_at":"2024-11-25T17:31:33.776Z","updated_at":"2025-04-12T09:40:50.600Z","avatar_url":"https://github.com/aesophor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch3\u003ePY-TODO\u003c/h3\u003e\n\u003cimg src=\"https://github.com/aesophor/py-todo/raw/master/.meta/scrot.png\"\u003e\n\n\u003c/div\u003e\n\n## Overview\nA little program to remind you of upcoming events / unfinished tasks.\n\nPut them into `~/.zshrc` or `~/.bashrc` or whatever you want, and it will stop you from\nputting off important shit.\n\nPickled (i.e., serialized) todo list objects are saved in ~/.local/share/py-todo/todo.dat by default.\n\n\n## Dependencies\n* python \u003e=3.5 (sys, re, pickle, pathlib, datetime)\n\n## Supported Platforms\n* Linux\n* OSX (tested on 10.14 Mojave)\n\n## Installation\n* Debian / Ubuntu / Mint - [Get latest deb](https://github.com/aesophor/py-todo/releases)\n```\nsudo dpkg -i py-todo_1.3.3-3_all.deb\n```\n\n* Arch Linux - [AUR](https://aur.archlinux.org/packages/py-todo) (Maintained by [RewoundVHS](https://github.com/RewoundVHS))\n```\nyay -S py-todo\n```\n\n* Manual Installation (Linux)\n```\n$ git clone https://github.com/aesophor/py-todo.git\n$ cd py-todo \u0026\u0026 sudo cp todo /usr/bin/todo\n```\n\n* Manual Installation (OSX)\n```\n$ git clone https://github.com/aesophor/py-todo.git\n$ cd py-todo \u0026\u0026 cp todo /usr/local/bin/\n```\n\n## Usage\n```\n$ todo                                   # List all items.\n$ todo -a                                # Add an item. (with Title / Expiry Date prompt)\n$ todo -a \u003ctitle\u003e \u003cexpiry_date\u003e          # Add an item. (without Title / Expiry Date prompt)\n$ todo -e \u003cindex\u003e                        # Edit an item. (with Title / Expiry Date prompt)\n$ todo -e \u003cindex\u003e \u003ctitle\u003e \u003cexpiry_date\u003e  # Edit an item. (without Title / Expiry Date prompt)\n$ todo -l --list                         # List all items.\n$ todo -m --move \u003cindex\u003e \u003cnew index\u003e     # Move an item from index to new index.\n$ todo -r \u003cindices\u003e                      # Remove one or more items.\n$ todo -s --sort                         # Sort items by their remaining days\n$ todo -h                                # Display help message.\n$ todo -v                                # Display version info.\n$ todo -org \u003cfilename\u003e                   # Adds TODOs from Emacs org mode\n```\n\n## Configuration (Optional)\nThe default config location is `~/.config/py-todo/config`\n\n```\n[PY-TODO]\ncolor = true / false\ndetail_mode = true / false\nweek_start_day = Sun\nshow_time = true\n```\n\n## Detail Mode\n```\nDiscrete Mathematics Exam (Next Wednesday; 5 days left)  # detail_mode = true\nDiscrete Mathematics Exam (5 days left)                  # detail_mode = false\n```\n\n## Contributors\nSpecial thanks to all the contributors! (In lexicographical order)\n* [Arsukeey](https://github.com/Arsukeey) - Added Detail Mode (e.g., Next Wednesday)\n* [christophergeiger3](https://github.com/christophergeiger3) - Reformatted code\n* [diplozoon](https://github.com/diplozoon) - Reformatted code\n* [jcstill](https://github.com/jcstill) - Add support for past due tasks\n* [jonaylor89](https://github.com/jonaylor89) - More robust config parsing\n* [luvhalvorson](https://github.com/luvhalvorson) - Updated README.md\n* [MMarinov97](https://github.com/MMarinov97) - Added compatibility with emacs org file\n* [patatman](https://github.com/patatman) - Improved -a --add. Tested py-todo on MacOS\n* [RewoundVHS](https://github.com/RewoundVHS) - AUR Package Maintainer, Color Mode\n* [Steampunkery](https://github.com/Steampunkery) - Added -e --edit, -m --move, refactoring\n\n## License\nAvailable under the [MIT License](https://github.com/aesophor/py-todo/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faesophor%2Fpy-todo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faesophor%2Fpy-todo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faesophor%2Fpy-todo/lists"}