Todol - Simple cli ToDo app

📦 Installation

pip install todol

More Info

• Check out the project page on PyPi: https://pypi.org/project/todol/
• and on Github: https://github.com/WattoX00/todol

🚀 Usage

Run from anywhere in your terminal

todol

Additional flags

todol --help

todol --version

todol --path

todol --upgrade

Modify the todo list from the terminal

todol --add [TASK_NAME] [@TAGS (optional)]

todol --done [TASK_ID]

todol --clear

COMMAND GUIDE

Commands:
  add, a        Add new task
  done, d       Mark task done
  list, ls      Show todo list
  edit, e       Edit task
  clear, c      Clear done tasks
  order, o      Order Todos by IDs
  help, h       Show help
  reload, rld   Reload the app
  exit, q       Exit app

• You can use Tab for autocomplete.
• Navigate the terminal efficiently: arrow keys, backspace, delete ...
• Use custom @tags to organize tasks
• You can execute multiple commands at once:

  • all - apply the command to all items

  • id-id – apply the command to a range of IDs

  • id1 id2 id3 – apply the command to specific IDs

examples:

done all       # marks all tasks as done
done 4-7       # marks tasks with IDs 4 through 7 as done
done 3 5 8     # marks tasks 3, 5, and 8 as done

❓ FAQ

Where are the saved todo files stored?

You can simply check it by running todol --path

todol stores its data using platformdirs.user_data_dir, which means files are written to the standard user data directory for each operating system.

Default locations

• Linux ~/.local/share/todol/todoFiles/

• macOS ~/Library/Application Support/todol/todoFiles/

• Windows %APPDATA%\todol\todoFiles\

Hotkeys

❤️ Support

If this project saved you time, taught you something, or made your day a little easier, you can support its development here:

👉 Buy me a coffee via PayPal

Your support helps keep the project:

• Actively maintained
• Continuously improved
• Free and open source

Thanks for being part of the community 🤝

📄 License

This project is licensed under the MIT License.
See the LICENSE file for full details.