https://github.com/kiblee/tod0
A Terminal Client for Microsoft To-Do
https://github.com/kiblee/tod0
cli microsoft microsoft-graph-api python terminal-based todo wunderlist
Last synced: 12 days ago
JSON representation
A Terminal Client for Microsoft To-Do
- Host: GitHub
- URL: https://github.com/kiblee/tod0
- Owner: kiblee
- License: mit
- Created: 2019-11-02T16:02:23.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2026-02-07T06:46:57.000Z (4 months ago)
- Last Synced: 2026-02-07T16:53:34.802Z (4 months ago)
- Topics: cli, microsoft, microsoft-graph-api, python, terminal-based, todo, wunderlist
- Language: Python
- Homepage:
- Size: 263 KB
- Stars: 139
- Watchers: 3
- Forks: 21
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.txt
- License: LICENSE
Awesome Lists containing this project
- awesome - kiblee/tod0 - A Terminal Client for Microsoft To-Do (Python)
README
tod0
====
A Terminal Client for Microsoft To-Do.
[](https://circleci.com/gh/kiblee/tod0)
#### Microsoft To Do Command Line Interface
`tod0` lets you use [Microsoft To Do](https://todo.microsoft.com/) from the command line.
Installation
------------
***Remember to [register for an API key](https://github.com/kiblee/tod0/tree/master/GET_KEY.md) before using `tod0`***
### Install from PyPI
```sh
pip install tod0
```
### Install from source
```sh
git clone https://github.com/kiblee/tod0.git
cd tod0
python setup.py install
```
Commands
--------
For the UI client, run `tod0` from anywhere on your terminal.
j Move selection down
k Move selection up
l Select folder and view tasks
h Go back to folder
n Create task/folder
c Mark task as complete
? Display help
For the CLI client, run `todocli` from anywhere on your terminal.
Usage:
NAME
todocli - Command line client for Microsoft ToDo
SYNOPSIS
todocli [options] COMMAND ...
'COMMAND' can be one of the following values:
ls Display all lists
lst Display all tasks from list
list_name Name of the list
new [-r time]
Create a new task
task Task to create. See 'Specifying a task' for details.
-r time Set a reminder. See 'Specifying time' for details.
newl Create a new list
list_name Name of the list
complete Set task status to completed
task Task to complete. See 'Specifying a task' for details.
rm Remove a task
task Task to remove. See 'Specifying a task' for details.
OPTIONS
-h, --help
Display a usage message.
-i, --interactive
Interactive mode.
Don't exit after invoking a command, but ask for follow up commands instead.
-n, --display_linenums
Display a line number for all lines which are output.
Specifying a task:
For commands which take 'task' as a parameter, 'task' can be one of the following:
task_name
list_name/task_name
task_number
list_name/task_number
If 'list_name' is omitted, the default task list will be used.
'task_number' is the position displayed when specifying option '-n'.
Specifying time:
For options which take 'time' as a parameter, 'time' can be one of the following:
{days}d{hours}h{minutes}m{seconds}s
Current time + specified time delta.
e.g. 1h, 12h, 1h30m
morning
Today at 07:00 AM if current time < 07:00 AM, otherwise tomorrow
tomorrow
Tomorrow at 07:00 AM
evening
Today at 06:00 PM if current time < 06:00 PM, otherwise tomorrow
{hour}:{minute}
Today at {hour}:{minute} if current time < {hour}:{minute}, otherwise tomorrow
e.g. 9:30, 09:30, 17:15
{hour}:{minute} am|pm
Today at {hour}:{minute} am|pm if current time < {hour}:{minute} am|pm, otherwise tomorrow
e.g. 9:30 am, 12:00 am, 10:15 pm
{day}.{month}. {hour}:{minute}
The given day at {hour}:{minute}
e.g. 24.12. 12:00
e.g. 7.4. 9:15
{day}.{month}.{year}
The given day at 7:00 am
e.g. 22.12.2020
e.g. 01.01.21
{start_value}/{end_value}/{time_delta}
Calculate the finish time according specified start/end values.
e.g. 0/100/1m -> 100 minutes
e.g. 15/35/17s -> 340 seconds
Features
--------
- View folders and tasks
- Create folders and tasks
- Mark tasks as complete