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.
-
Create a filter so that all subject mails end up in the same folder/label.
-
gem install things-fetcher
-
Run
things-fetcher
in Terminal to generate a default config file at~/.things_fetcher
-
Edit the config file at
~/.things_fetcher
to specify your email and so on. -
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¶ ↑
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