RTMFetch is a python command line tool designed to work with GeekTool. RTMFetch shows tasks from Remember The Milk matching options you specify.
Installation
Steps to install RTMFetch
- Download the latest release and unarchive it
- Place the resulting folder in any directory you like (this guide is going to assume you placed it in your Applications directory)
- Open Terminal.app, you can find this in Applications/Utilities/Terminal
- Move into your RTMFetch directory, default this would be:
cd /Applications/RTMFetch <version number>
- Enter: python rtmfetch.py --username=<your RTM username> --store --password
- Now go into your GeekTool Preference Pane and in the command section enter:
python /Applications/RTMFetch <version number>/rtmfetch.py <arguments>RTMFetch requires your RTM username and password to function. Issuing command 5 will automatically store your password in the keychain for future use. If you do not want this omit the '--store' section. If you do not store your password, you have to supply it every time you use RTMFetch and using it with GeekTool will not be possible. The arguments and how to use them is described in more detail in the 'Basic usage' and 'Beyond basic usage' sections.
Basic usage
To use RTMFetch you give it a set of options a task should have. You can see a list of options by running:
python rtmfetch.py --help
All specified options are treated individually, meaning: if you specify multiple tags and multiple due dates RTMFetch will show all tasks that match ANY of these options. For example this command:
python rtmfetch.py -u klapy -p 1 --dues 'today, 090317'
Will show all tasks that have a priority of 1 or a due date of today or 17 march 2009.
Beyond basic usage
As of version 1.1 RTMFetch also supports the 'before' and 'after' modifiers. This means that if you specify a date with before or after in front of it, all tasks that are due before that date will be displayed. For example this command: python rtmfetch.py -u klapy --dues='before today' Will show all tasks that are overdue and this command:
python rtmfetch.py -u klapy --dues='after 090101' Will show all tasks due after 1 January 2009
Issues
If you encounter any problems, please add a issue. When doing so please add your iCalendar file to the issue. You can get your iCalendar file from RTM by going to 'Settings->Other'. Download the 'iCalendar Service (All Lists)'
Additional information
Want to know more about RTMFetch, contact me at: (my firstname (klaaspieter) at annema dot me) or follow me on Twitter.
