https://github.com/dooit-org/dooit

An awesome TUI todo manager
https://github.com/dooit-org/dooit

cli python3 rich terminal-based textual todo-app todolist tui unixporn

Last synced: 6 days ago
JSON representation

An awesome TUI todo manager

• Host: GitHub
• URL: https://github.com/dooit-org/dooit
• Owner: dooit-org
• License: mit
• Created: 2022-04-19T14:49:10.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-02T17:02:53.000Z (14 days ago)
• Last Synced: 2025-04-03T05:04:46.934Z (13 days ago)
• Topics: cli, python3, rich, terminal-based, textual, todo-app, todolist, tui, unixporn
• Language: Python
• Homepage: https://dooit-org.github.io/dooit/
• Size: 9.68 MB
• Stars: 2,442
• Watchers: 18
• Forks: 102
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-rainmana - dooit-org/dooit - An awesome TUI todo manager (Python)
• awesome-github-repos - dooit-org/dooit - An awesome TUI todo manager (Python)
• my-awesome - dooit-org/dooit - based,textual,todo-app,todolist,tui,unixporn pushed_at:2025-04 star:2.4k fork:0.1k An awesome TUI todo manager (Python)

README

        
![DOOIT](imgs/banner.png)

# Dooit ✔️

*A todo manager that you didn't ask for, but needed !*

[![Wiki](https://img.shields.io/badge/Wiki-Dooit-white?style=flat-square)](https://dooit-org.github.io/dooit/)

![PyPI Downloads](https://static.pepy.tech/badge/dooit)

[![GitHub issues](https://img.shields.io/github/issues/dooit-org/dooit?color=red&style=flat-square)](https://github.com/dooit-org/doit/issues)

[![GitHub stars](https://img.shields.io/github/stars/dooit-org/dooit?color=green&style=flat-square)](https://github.com/dooit-org/doit/stargazers)

[![Support Server](https://img.shields.io/discord/989186205025464390.svg?label=Discord&logo=Discord&colorB=7289da&style=flat-square)](https://discord.gg/WA2ER9MBWa)

-----------------------------

For installation and configuration, check out [the wiki](https://dooit-org.github.io/dooit/)

# Features 🌟

- An interactive & beautiful UI

- Fully customizable, you can configure your bar, your colors and how everything is displayed!

- Extensible, python config file allows you to do as much as you like!

- Vim like keybindings

- Topicwise separated Todo Lists (With branching)

**Note: See [CHANGELOG.md](CHANGELOG.md) to get more details on changes and feature additions!**

# Usage and configuration :gear:

After launching the app, You can press the `?` key to know the keybindings!

# Screenshots 🖼️

> [!NOTE]

> The configurations below heavily use [Dooit Extras](https://github.com/dooit-org/dooit-extras)

Some screenshots of app with different customized configuration <3

  An icy configuration based on NordTheme ❄️ 

  

![Preview 1](./imgs/config1.png)

  A colorful configuration based on Catpuccin 🐱 

  

![Preview 2](./imgs/config2.png)

  

  A calm configuration based on Everforest 🌲 

  

![Preview 3](./imgs/config3.png)

# Contribution 🤝

- Want to contribute? Feel free to open a PR! 😸

- Got some ideas for improvements? I'm all ears! 👂

- If you have an idea that related to customizability, open an issue at [Dooit Extras](https://github.com/dooit-org/dooit-extras/issues/new) instead

----------------------------

#### Other TUI projects 🤓 :

If you liked dooit then you might wanna try out some of my other TUI projects as well

- [smassh](https://github.com/kraanzu/smassh) - A typing-test app for terminal