Skip to main content

manage todolist of todotxt

Project description


Python cli for manage todolist


pip install todotxt-cli


git clone
cd todotxt-cli
python install

You can load test by

python -m unittest discover -s test


>> todo
Usage: todo [OPTIONS] COMMAND [ARGS]...

    -vv, --verbose
    -c, --conf FILENAME
    --version            Show the version and exit.
    --help               Show this message and exit.

    add       add task
    append    append task
    cancel    cancel words in task
    done      done task
    due       change due of task
    ls        list of tasks
    priority  change priority of task
    prune     remove task if done and today - x days >= completed x is 10 by...
    repeat    repeat add param in task for manage repeat
    rm        remove task
    txt       change txt of task and save due
    undone    undone task

Sample of Usage

>> todo ls
>> todo add test One
    [ ] 0 test One
>> todo add test two due:2019-11-01
    [ ] 1 test two due:2019-11-01
>> todo add test Three
    [ ] 2 test Three
>> todo ls
    [ ] 0 test One
    [ ] 1 test two due:2019-11-01
    [ ] 2 test Three
>> todo rm 2
>> todo ls
    [ ] 0 test One
    [ ] 1 test two due:2019-11-01
>> todo done 1
    [X] 1 test two due:2019-11-01
>> todo ls
    [ ] 0 test One
    [X] 1 test two due:2019-11-01
>> todo append 1 +project
    [X] 1 test two due:2019-11-01 +project
>> todo ls
    [ ] 0 test One
    [X] 1 test two due:2019-11-01 +project


You can add file conf in application folder

Mac OS X: ~/Library/Application Support/todocli

Mac OS X (POSIX): ~/.todocli

Unix: ~/.config/todocli

Unix (POSIX): ~/.todocli

Win XP (roaming): C:Documents and Settings<user>Local SettingsApplication Datatodocli

Win XP (not roaming): C:Documents and Settings<user>Application Datatodocli

Win 7 (roaming): C:Users<user>AppDataRoamingtodocli

Win 7 (not roaming): C:Users<user>AppDataLocaltodocli

sample of file conf

Log=40 #0,10,20,30,40

use a specific conf

>> todo -c myconf.conf ls

If you want multi todolist:

  • todo
  • shopping

create a specific conf: $HOME/shopping.conf with:


and add a alias

alias shopping="todo -c $HOME/shopping.conf"

you can use

shopping ls

If you use a webdav for save file (with user/password authentification)


If you want load a webdav server, you can user docker

docker run -d -v <localpath>:/share --name webdav -p 80:80 fraoustin/webdav


  • graphic
  • unittest with click

V. 0.1.0

  • init

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for todotxt-cli, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size todotxt-cli-0.3.1.tar.gz (26.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page