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 (c) 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: https://github.com/look/fetcher