Wunderlist Workflow for Alfred
Beginner and advanced approaches to adding a monthly repeating task beginning the following week:
|Jump to:||Setup||Add Tasks||Search and Browse Tasks||Editing Tasks||Hints|
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.
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
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.
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.
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.
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.
wl h:Fix the broken step saturday morning*
wl Buy clicky keyboard in shopping due sat
wl Rearrange file cabinet tomorrow in WO
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).
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 weekly meeting notes r 8am due 1d
wl Laundry remind me
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
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
View a list
Search within a list
Search across all lists
Your search will match against tasks as well as list names.
Browse tasks by hashtag
Type the hash symbol # to view and select a tag.
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:
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.
Due and overdue tasks
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.
This view is searchable, just type to filter the results by keyword.
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.
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.
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.
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.
wl:pref have been changed to
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.
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.
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
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.
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.
- 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.
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.
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.
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.
- 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.