Skip to content

Unbelievably fast task entry in Wunderlist with due dates, reminders, and recurrence

Notifications You must be signed in to change notification settings

idpaterson/alfred-wunderlist-workflow

Repository files navigation

Wunderlist Workflow for Alfred

Create tasks in Wunderlist more effortlessly than ever before with this Alfred workflow (requires Alfred 2 or 3 with a Powerpack license).

Beginner and advanced approaches to adding a monthly repeating task beginning the following week:

Simple and advanced usage


Jump to: Setup Add Tasks Search and Browse Tasks Editing Tasks Hints

Setup

After downloading, simply double-click to install the workflow in Alfred. Use the wl command in Alfred to activate the workflow, or assign a hotkey in Alfred preferences. The workflow will guide you through securely logging in to Wunderlist and will even let you know when an important update is available.

Add tasks

The workflow provides an easy guided experience with tips along the way that will help you become a power user.

The welcome screen appears when you've typed wl (and nothing else). Special commands are in the form wl-command with no space; once you type a space after wl you're in task entry mode. Partial commands are matched, so rather than typing wl-upcoming to get to the Upcoming tasks list you can type as little as wl-up or even wlu.

Welcome screen

Adding tasks with due dates and recurrence

Add your first task! As you type, the workflow will pick out due dates and recurrence intervals in just about any format you could think of. Just write naturally, the due date, recurrence, and task text are updated in Alfred as you type.

Task with due date and recurrence

Use the menus to configure your task until you become a power user capable of typing everything manually. It's so worthwhile to be able to drop tasks into Wunderlist in under a second.

Due date menu

Adding tasks to a specific list

To select a list, type it first followed by a colon or use the Change list menu item. No need to type the full list name, as long as you see the correct list in Alfred a few letters is usually sufficient. You can also set a default list or default to the most recently used list.

List by substring matching

You can also select a list after typing your task with the "in" keyword. To avoid false positives you will need to use all-caps in order to match a list by typing fewer than 3 characters.

Examples

wl h:Fix the broken step saturday morning*

wl h:Fix the broken step saturday morning*

wl Buy clicky keyboard in shopping due sat

Buy clicky keyboard in sho due sat

wl Rearrange file cabinet tomorrow in WO

wl Rearrange file cabinet tomorrow in WO

Reminders

Wunderlist uses alerts to remind you about tasks that are due, either on the due date or in advance. To set a reminder, either include a time with your due date or use an explicit reminder phrase like remind me at 3:00pm on June 11).

Examples

wl Pay DoubleCash credit card bill monthly June 26th remind me June 22

wl Pay DoubleCash credit card bill monthly June 26th remind me June 22

wl Make a New Year's resolution reminder: Jan 1 at midnight

wl Make a New Year's resolution reminder: Jan 1 at midnight

wl weekly meeting notes r 8am due 1d

wl weekly meeting notes r 8am due 1d

wl Laundry remind me

wl Laundry remind me

wl Ask about app icon at dinner tomorrow

wl Ask about app icon at dinner tomorrow

When is the reminder?

You can set a custom default reminder time from the workflow preferences screen, otherwise when a time is not specified the reminder will be set for 9am.

Reminder phrase includes Task without due date Task with due date
Time only Reminder today at the specified time Reminder on the due date at the specified time
Neither time nor date Today, 1 hour from the current time* Default time (9am) on the due date**
Date and time Exact date and time entered Exact date and time entered
Date only Default time (9am) on the specified date** Default time (9am) on the specified date**

* By default, reminders for the current day will be set to 1 hour from the current time. You can change this offset in the workflow preferences.

** The default time can be changed in the workflow preferences. If the specified date is today, your reminder date offset preference will be used instead.

Search and browse tasks

The wl-search command allows you to search tasks by keyword or browse by list. To seach within a list, use the same wl-search My List: some query syntax as when entering a task.

Default search view

search

View a list

view list

Search within a list

search list

Search across all lists

Your search will match against tasks as well as list names.

search

Browse tasks by hashtag

Type the hash symbol # to view and select a tag.

hashtags

Upcoming tasks

View upcoming tasks at wl-upcoming. It's kind of like the Week smart list in Wunderlist with the option to choose the duration that you prefer to look ahead (1 week, 2 weeks, 1 month, 3 days, whatever...). Like any other screen you can get there by typing as little as the first letter of the command: wlu:

upcoming tasks

Browse or type to search your upcoming tasks. This screen can show upcoming tasks for any number of days with a few sensible defaults. Maybe there is someone out there who needs to see exactly 11 days ahead.

upcoming duration

Due and overdue tasks

The wl-due command shows tasks that are due or overdue, similar to the Today list in Wunderlist. By default it hoists any recurring tasks that are multiple times overdue to the top, but you can change the sort order. Sadly, I have quite a few tasks that are multiple times overdue, so this feature is mostly to keep me motivated but I hope others find it useful as well.

due and overdue tasks

This view is searchable, just type to filter the results by keyword.

In sync

The workflow stays in sync with Wunderlist, so your lists and tasks will be up-to-date and searchable. The due and upcoming screens will sync (or wait for the already-running sync) before showing results to make sure that everything is up-to-date. A notification is displayed if there is something to sync so that you're not waiting around too long without any feedback.

Editing tasks

Tasks can be completed or deleted directly from the workflow. Simply find a task through the search, due, or overdue screens. Task editing is currently limited to completing and deleting tasks.

edit a task

Overdue recurring tasks can be set due today to adjust the next occurrence by holding the alt key while marking a task complete. For example, if you are supposed to water the plants every 3 days but forget and do it 2 days late, you don't need to water them again the following day.

View in Wunderlist

Any task can be opened in the Wunderlist desktop app for further editing. This is a quick way to view notes, subtasks, assignees, and other features that are not yet supported in the workflow.

You can also open a new task in Wunderlist by holding down the alt key when creating the task.

view in Wunderlist

Hints

Read the text below each menu option and you'll be on your way to power user status – most menu items include helpful tips about how to apply a setting without navigating the menu.

Command shorthand

Commands like wl:list and wl:pref have been changed to wl-list and wl-pref to allow alt+delete to return you to the welcome screen (any non-word character is fine, I just chose - for its word breaking properties). Furthermore, these commands can be triggered with as little as the first letter. wld will get you to the wl-due screen and wls will get you to wl-search. For this reason, you may noticed that top-level commands are first-letter-distinct to avoid conflicts.

Default list

There is an option in wl-pref to set a list other than Inbox as the default when entering tasks. This will save keystrokes when entering a large number of tasks into a list or when a custom list is preferred over Inbox. You can also elect to use the previously-used list to facilitate entry of multiple tasks in the same list.

default list

Changelog

If you notice any problems or want to see what changed in the latest version, jump to the About screen from the main menu or type wl-about.

About screen

Experimental updates

Those who want to help test the newest features of the workflow can enable experimental updates in the wl-pref screen. When enabled, the workflow will prompt you to update to alpha and beta releases for the next major version. Note that these may be unstable and feedback is always appreciated if something goes wrong.

If you are currently using an experimental version the workflow will always prompt you to update to the latest experimental update regardless of this setting. Since fixes are common and often very important during this early stage of development it would not be good to allow old beta versions to continue misbehaving.

Security

Your Wunderlist password is never made available to the workflow or stored in any way. Instead, when you log in through the Wunderlist portal you are asked to authorize the workflow to access your account.

You can log out at any time through the wl-pref preferences screen. Upon logging out, all caches, synced data, and workflow preferences are removed. To revert to the default workflow settings simply log out then log back in.

Limitations

  • No offline mode – the workflow must be able to connect the the API for each change you make; currently changes made while offline are not saved.
  • Languages and date formats – the workflow only officially supports US English at this time. parsedatetime provides US English, UK English, Dutch, German, Portuguese, Russian, and Spanish with varying coverage of keywords (e.g. tomorrow, Tuesday) in each language; your mileage may vary with these languages.

Contributing

So you want to help make this workflow better? That's great! After cloning the repository, run npm install && grunt to build the workflow. Open the Wunderlist-symlinked.alfredworkflow file to install a copy in Alfred that will update whenever you rebuild the workflow. After making a change, simply run grunt build to update the workflow then use Alfred to test. Using this process, the workflow is kept up-to-date while you work.

Always run through the tests to ensure that your change does not cause issues elsewhere. When possible, add corresponding tests for your contributions.

Testing

Unit tests are run automatically on every commit to reduce the likelihood of introducing a bug. Nevertheless, your feedback is crucial if anything seems to be broken.

Contributors can use the command grunt test to run the test suite and should do so to validate changes in any pull requests. If you add functionality, please back it with unit tests.

Acknowledgements

This workflow relies on the fantastic Alfred-Workflow by Dean Jackson to communicate with Alfred. The Alfred-Workflow library source code is bundled with the workflow and also included with the repository as a submodule.

Much of the natural language date processing is powered by parsedatetime, a tremendously powerful date parser built by Mike Taylor and various contributors. Peewee by Charles Leifer provides a simple interface to store and query synced data retrieved from Wunderlist using Requests by Kenneth Reitz. The source code of all three libraries is bundled with the workflow and each is included in the repository as a submodule.

Alternatives

  • Wunderlist itself! The 6Wunderkinder team has been incorporating many of the features found in this workflow directly into the app so that you can enjoy the convenience of natural language due dates and reminders across all platforms.