Skip to content

Latest commit

 

History

History
93 lines (51 loc) · 2.96 KB

README.md

File metadata and controls

93 lines (51 loc) · 2.96 KB

Pick a Random To Do from your Remember the Milk list(s)

Do you have way too many things to do and don't know where to start? Use this script to randomly pick an item from your RTM account!

Prerequisites

  • Python 2.7.x - primarily due to the RtmAPI module being built with this version.
  • Python modules (pip install these):
    • rtmapi
    • httplib2
    • colorama
    • progress

Installing

Clone this repo to your local computer.

Usage

Run rtmr.py. e.g.:

./rtmr.py

or perhaps:

python2.7 rtmr.py

Options

  • -l / --list - specify an RTM list to search within. Note that if your list has spaces in it, you must quote it. i.e. "Home Tasks" or 'Grocery List'
  • -t / --tag - specify an RTM tag to search within or add to your search filter.
  • -p / --priority - specify an RTM priority to search within or add to your search filter.
  • -e / --estimate - specify the upper limit of the time estimate of the task (in hours or minutes).

Examples

Find a random task in all of your RTM tasks:

./rtmr.py

Find a random task in your Home Stuff list:

./rtmr.py -l 'House Stuff'

Find a random task that is tagged as financial:

./rtmr.py -t financial

Find a random task in your Home Stuff list that is also tagged with the financial tag:

./rtmr.py -l 'House Stuff' -t financial

Find a random priority 1 task that is tagged as financial:

./rtmr.py -p 1 -t financial

Find a random task in your Current list with a maximum time estimate of 2.5 hours:

./rtmr.py -l current -e 2.5

./rtmr.py -l current -e 2.5h

Find a random priority 1 task with a maximum time estimate of 10 minutes (for the -e flag, use any word after the # starting with 'm'):

./rtmr.py -p 1 -e 10m

./rtmr.py -p 1 -e 10mins

Note that specifying multiple search filter flags ANDs them together (not OR).

Bonus Script - Randomize a List of Ordered Numbers, 1 to N.

Many days, I have To Dos that crop up outside of what's in RTM. I tend to write these down. To fight the overwhelm, I number the items, then randomize the list using the shuffle.py script.

For example, if I have 4 items (1, 2, 3, 4 ), after shuffling the list, it may become [3, 1, 4, 2].

Contributing

Please add your suggestions, bugs you've found or send us pull requests via this GitHub repo!

The point of this tool is to make your life a little bit more manageable by removing one more decision - what to do/where to start? So that means it should not make it more complicated by having/adding so many features that you need to do/learn 1 more thing! As much as I like powerful software, I've fought the urge to add every single feature that has occurred to me.

Authors

  • Khalid J Hosein

License

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0) - see the LICENSE file for details.

Disclaimer

This utility uses the Remember The Milk API but is not endorsed or certified by Remember The Milk.