Skip to main content

Functions to manage the 2DoApp from the command line.

Project description


This package provides the library twodolib and a command line utility task2do to add tasks, projects and checklists to the macOS App 2DoApp from the command line.

Since version 1.5 (Mac) 2Do supports adding tasks by using an URL scheme. For example, if you want to add the task Save the world., you can open the URL:


to add this task to your 2Do App (see:

The task2do command supports creating such URLs from the command line. To print such an URL for a task without adding it, just enter:

task2do "Save the world."

which prints the URL to stdout like this:


If you want to actually add the task to your 2Do App, use the -e or --execute option:

task2do -e "Save the world."
# no output here, but the task should be added into your standard list in 2Do


  • runs with Python 3 (if you need py27 support please use release 0.4.0)
  • Create tasks on the command line and show the corresponding URL scheme, for copy and pasting it.
  • Create tasks on the command line and open the corresponding URL scheme to send it to 2DoApp

See the documentation at


See docs/installation.rst (It’s just pip install twodolib)


  • wheel


  • Free software: ISC license


0.5.4 (2019-07-28)

updated HISTORY.txt file (gosh!)

0.5.3 (2019-07-28)

removes unnecessary dependencies.

0.5.2 (2019-07-15)

Updated requirements.

0.5.1 (2018-11-14)

Please update, because package requests was updated for security reasons!

  • updated requirements

0.5.0 (2018-08-08)

  • dropping Python 2.7 support
  • implemented forParentName
  • print taskid

0.4.0 (2018-08-07)

  • you can paste tasks now, even as subtasks of a project. See help or docs!
  • minor fixes

0.3.0 (2017-05-28)

  • added ‘action’ property of tasks (e.g. url, phone, …)
  • switched from to[‘open’, …)

0.2.1 (2015-09-21)

  • fixed classifier in
  • fixed #3 - adding to lists works now.

0.2.0 (2015-09-20)

  • first public release.

0.1.0 (unreleased)

  • ADD: more commandline options implemented: repeat, due, dueTime, start
  • ADD: docs

0.0.1 (2015-09-14)

  • not released - pre alpha.

Project details

Download files

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

Files for twodolib, version 0.5.4
Filename, size File type Python version Upload date Hashes
Filename, size twodolib-0.5.4-py2.py3-none-any.whl (9.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size twodolib-0.5.4.tar.gz (23.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page