https://github.com/eploko/things-fetcher

Imports TODOs from IMAP to Things.app
https://github.com/eploko/things-fetcher

Last synced: 3 months ago
JSON representation

Imports TODOs from IMAP to Things.app

• Host: GitHub
• URL: https://github.com/eploko/things-fetcher
• Owner: eploko
• License: mit
• Created: 2012-05-19T15:23:16.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2012-05-19T17:32:01.000Z (about 14 years ago)
• Last Synced: 2025-12-05T14:44:35.431Z (8 months ago)
• Language: Ruby
• Size: 121 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rdoc
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this 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

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}[http://slantwisedesign.com].

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