Remember The Milk Plugin

Personal tools
From GNOME Do Wiki
Jump to: navigation, search

You can add, remove, or configure this plugin in the latest versions of Do by clicking the arrow at the upper right corner of Do's window and selecting Preferences.

Add a new task to "Personal" list using Remember The Milk plugin
Add a new task to "Personal" list using Remember The Milk plugin

Remember The Milk plugin indexes the tasks which are stored in your Remember The Milk account. It also allows you to perform basic actions like creating or deleting a task, as well as some advanced operations related to task lists, tags and locations. It requires an available Remember The Milk account and needs to be authorized to access the data.

Contents

Configuration

Configuration Window
Configuration Window

Authorization

After enable this plugin in the Plugin page of GNOME Do's Preferences Dialog, an authorization process should be completed before the plugin is able to operate on the data of a certain Remember The Milk account.

Account Authorization in the Configuration Window

To authorize Do, click on the Authorize button, a web page will be open in your web browser which shows the Authoize API Access interface -- if you have not logged in your account, you have to do so before you can see the page. Click on the OK, I'll allow it button, a new page titled Application successfully authorized should present. Then go back to the plugin configuration window and click on the Complete the authorization button the finish the process.

After authorization, the button will change to Sign in as a different user. When you need to switch to another account to integrate with Do, you can click it to initial a new authorization process. (Note: before doing this, please make sure to logout from the old account.)

Interactivity

In the Interactivity section of the Configuration window, there are a few options to change how this plugin interacts with you:

  1. You can decide whether and how often you are notified about any overdue task in your account.
  2. You can turn on/off the notification which will show after each action is completed.
  3. You can choose if the "New Task" action should return the newly created task for further operations.

Filter

Filter setting is an advanced feature which allows you to precisely control what kind of tasks you want Do to index. It is a string containing one or more Operators which will be sent to Remember The Milk's server when doing the query for retrieving tasks.

By default, it is set to be "status:incomplete" which means all incomplete tasks will be downloaded and indexed by Do. You can change it by modifying the content of the text field in the Configuration window. For example, changing it to "priority:1 And status:incomplete" will let Do index all tasks which are incomplete AND have the highest priority. A complete reference for all operators can be found at this FAQ page at Remember The Milk website.

Usage

Add a New Task

  1. Type the task you want to add
    1. Put !1, !2, or !3 at the begining to set the priority
    2. Put a date at the end to set the data
    3. For example "!2 Get some milk tomorrow"
  2. Press Tab to move to the next pane
  3. Cursor down and selet "New Task" or just start typing "New Task"
  4. Press Tab to move to the 3rd pane
    1. If you want to file in the Inbox you can just hit enter instead.
  5. Cursor down or start typing to select a list to file the task in

Change Properties of a Task

  1. Type the name of a List (You may have to cursor down if something else has the same name as your list)
  2. Press the Right Arrow to move into the list and select a task
  3. Press tab to move to the second pane
  4. Now select an action by either Curosring down or begining to type the action name
    1. Some actions like Delete, Complete, and Postpone do not require any more information so you can press enter once they are selected
    2. For actions that require more information (such as Rename, Set Recurrance, Move To, Set Priority, and Set Due Date/Time) you need to press tab to move to the 3rd pane to complete the information

Screencasts

The following screencasts exhibiting several usages of this plugin.

Known Issues

Author

This plugin is originally created by Peng Deng.


Do things as quickly as possible (but no quicker) with your files, applications, contacts and more!

© GNOME Do Developers. All rights reversed. Contact us.