Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mecaneer23/ndo
A vim-based terminal todo helper
https://github.com/mecaneer23/ndo
application curses ncurses ndo python python3 todo todolist tui vim
Last synced: about 2 months ago
JSON representation
A vim-based terminal todo helper
- Host: GitHub
- URL: https://github.com/mecaneer23/ndo
- Owner: mecaneer23
- License: mit
- Created: 2023-03-18T17:40:17.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T23:39:01.000Z (9 months ago)
- Last Synced: 2024-04-14T07:56:33.838Z (9 months ago)
- Topics: application, curses, ncurses, ndo, python, python3, todo, todolist, tui, vim
- Language: Python
- Homepage: http://mecaneer23.net/Ndo/
- Size: 513 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ndo - an ncurses todo application
[](https://app.codacy.com/gh/mecaneer23/Ndo/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
A curses implementation of a todo list helper. Most of the keybindings are similar to Vim-bindings so Vim users should feel relatively comfortable.
## OS Support
- Ndo is optimized for Linux, as most Vim users use Linux.
- MacOS is also supported however some keyboard shortcuts use different modifier keys.
- In Windows, general editing is available using the following [external package](#curses-for-windows), although some keyboard shortcuts might not work.
## Setup
### Magnify, copy, and paste
```bash
pip install pyfiglet pyperclip
```
### Curses for Windows
```bash
pip install windows-curses
```
## Running
```bash
python3 todo.py [options] [filename]
```
Or with Docker:
```bash
./docker_build.sh
./docker_run.sh filename
```
## Flags
Positional arguments:
| Argument | Description |
| -------- | -------------------------------------------------------------------- |
| filename | Provide a filename to store the todo list in. Default is `todo.txt`. |
Options:
| Option | Description |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| --bullet-display, -b | Boolean: determine if Notes are displayed with a bullet point in front or not. Default is `False`. |
| --enumerate, -e | Boolean: determines if todos are numbered when printed or not. Default is `False`. |
| --ui {curses,ansi,tkinter,none}, -g {curses,ansi,tkinter,none} | UiType: determine how todos should be rendered. Default is `ansi`. If `none` is passed, print state of a todolist to stdout without a user interface. |
| --help, -h | Show this help message and exit. |
| --help-file HELP_FILE | Allows passing alternate file to specify help menu. Default is `README.md`. |
| --indentation-level INDENTATION_LEVEL, -i INDENTATION_LEVEL | Allows specification of indentation level. Default is `2`. |
| --relative-enumeration, -r | Boolean: determines if todos are numbered when printed. Numbers relatively rather than absolutely. Default is `False`. |
| --simple-boxes, -x | Boolean: allow rendering simpler checkboxes if terminal doesn't support default ascii checkboxes. Default is `False`. |
| --strikethrough, -s | Boolean: strikethrough completed todos - option to disable because some terminals don't support strikethroughs. Default is `False`. |
| --title TITLE, -t TITLE | Allows passing alternate header. Default is `filename`. |
## Controls
| Key (arranged alphabetically) | Description |
| ------------------------------------------------------------------------ | ----------------------------------- |
| - | Insert blank line |
| / | Search for a sequence |
| Alt+g/Alt+Shift+g | Select all todos above/below |
| Alt+k/j | Move todo up and down |
| Backspace | Combine with previous todo |
| Ctrl+a | Select all todos |
| Ctrl+r | Redo change |
| Ctrl+x, k | Toggle `toggle` and `entry` modes |
| Delete | Toggle between `Todo` and `Note` |
| Enter | Toggle a todo as completed |
| Numbers | Move a number of lines |
| Shift+k/j | Select/deselect multiple todos |
| Shift+o | Add a todo on current line |
| Tab/Shift+Tab | Indent/unindent selected todo |
| a | Display selected todo as an alert |
| b | Make selected todo bigger (magnify) |
| c | Change selected todo color |
| d | Remove selected todo |
| g/Shift+g | Jump to top/bottom of todos |
| h | Show a list of controls |
| i | Edit an existing todo |
| k/j | Move cursor up and down |
| o | Add a new todo |
| p | New todo from clipboard |
| q, Ctrl+c, Esc | Quit |
| s | Sort top-level todos various ways |
| u | Undo change |
| y | Copy todo to clipboard |
## View a todo list online
Go to [this link](https://mecaneer23.github.io/Ndo/web-display) and upload your file
## Contributing
Use the following linters and formatters:
### Python files
- pylint
- black
- ruff
- mypy
- vulture
### Markdown files
- markdownlint
## Troubleshooting
### Docker error
`Cannot connect to the Docker daemon at ... Is the Docker daemon running?`
```bash
systemctl start docker
```
## Bugs
- Long todos don't render properly in strikethrough mode (in certain terminals)