henkka/terminal-to-do
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A to-do-kanban application for terminal. Written with python.
8 commits 1 branch 0 tags 45 KiB
  • Python 100%
Find a file
Exact
MacStache 9c089d1656 Change to default selected color
2026-02-15 14:07:58 +02:00
app.py Change to default selected color 2026-02-15 14:07:58 +02:00
LICENSE Initial commit 2026-02-15 08:03:57 +00:00
README.md Update README.md 2026-02-15 11:41:09 +00:00

README.md

terminal-to-do

A to-do-kanban application for terminal. Written with python.

How to run?

  1. Download and install Python 3 (Requires 3.10+)

    On Windows you also need to install curses:

   pip install windows-curses
  1. Clone the project:
   git clone https://forge.henkkalaukka.fi/henkka/terminal-to-do.git
  1. Go to the project directory:
   cd terminal-to-do
  1. Run the app:
   python3 app.py

The app has a landing page where you can create, rename or delete boards.

On first run the app will create a hidden ~/.todo_boards/ directory to save the board .json locally.

If you want to change the directory edit this line:

   BOARDS_DIR = Path.home() / ".todo_boards"

You could just save the .json in a visible location instead and also sync that folder into a cloud drive so your to-do-boards will sync from one place to the other. It's up to you how you use this.

Motivation for the app

This was created for my personal use as I find using web-based to-do/kanban boards a bit tedious to use and I don't remember to check them or add items. With this board I can just leave it running in a terminal and have it always visible on my screen. And even access via SSH if I wanted. So. There you go.