0.0
No commit activity in last 3 years
No release in over 3 years
A simple daemon to periodically check an IMAP folder and create a new to-dos in the Things app for each new message.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0

Runtime

 Project Readme

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