michel-orgmode / README.md

Michel-orgmode is a fork of michel which serves as a bridge between an org-mode textfile and a google-tasks task list. It can push/pull org-mode text files to/from google tasks.

Usage

Configuration

At the first run, you will be shown a URL. Click it, and authorize michel. You're done!

The authorization token is stored in $XDG_DATA_HOME/michel/oauth.dat. This is the only information stored.

Command line options

usage: michel [-h] (--push | --pull | --sync) [--orgfile FILE]
              [--listname LISTNAME]

optional arguments:
    -h, --help           show this help message and exit
    --push               replace LISTNAME with the contents of
                         FILE.
    --pull               replace FILE with the contents of
                         LISTNAME.
    --sync               synchronize changes between FILE and
                         LISTNAME.
    --orgfile FILE       An org-mode file to push from / pull to
    --listname LISTNAME  A GTasks list to pull from / push to (default list if
                         empty)

Org-mode Syntax

This script currently only supports a subset of the org-mode format. The following elements are mapped mapped between google-tasks and an org-mode file:

  • Indented Tasks <-> Number of preceding asterisks
  • Task Notes <-> Headline's body text
  • Checked-off / crossed-out <-> Headline is marked as DONE

Installation Dependencies

The michel.py script runs under Linux (not tested on other platforms yet). To run the script, you need to install the following dependencies:

About

Author/License

  • License: Public Domain
  • Original author: Christophe-Marie Duquesne (blog post)
  • Author of org-mode version: Mark Edgington (bitbucket site)

Contributing

Patches are welcome, as long as they keep the source simple and short.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.