things-fetcher

A simple tool to fetch messages from an IMAP folder and create a new to-do item in the Things app for each.

How It Works

Say, you use Gmail. Say, you want all the mail with [todo] in the subject field to be automatically routed to your Things’ Inbox.

  1. Create a filter so that all subject mails end up in the same folder/label.

  2. gem install things-fetcher

  3. Run things-fetcher in Terminal to generate a default config file at ~/.things_fetcher

  4. Edit the config file at ~/.things_fetcher to specify your email and so on.

  5. Run things-fetcher in Terminal.

Set up a cron task to run things-fetcher periodically.

Configuration

The following options can be specified in the ~/.things_fetcher file:

username

The username to authenticate with. You must specify one.

password

The password to authenticate with. Default is to use the Keychain.

server

The IP address or domain name of the IMAP server. Defaults to imap.gmail.com.

port

The port to connect to. Defaults to 993.

ssl

Set to any value to use SSL encryption. Enabled by default.

use_login

Set to any value to use the LOGIN command instead of AUTHENTICATE. Some servers, like GMail, do not support AUTHENTICATE. Enabled by default.

in_folder

The name of the folder from which to read incoming mail. Defaults to Things.

error_folder

The name a folder to move mail that causes an error during processing. Defaults to Things.

list

The list in Things to create TODOs in. Defaults to Inbox.

tag_names

The tags to apply to the newly created TODOs. Defaults to Texted.

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Copyright © 2012 Andrey Subbotin. See LICENSE for details.

The IMAP fetching code

Created by Dan Weinand and Luke Francl. Development supported by Slantwise Design. Licensed under the terms of the MIT License. Be excellent to each other.

The original repo can be found at: github.com/look/fetcher