Skip to content

✏️ Displays open Wunderlist tasks on the mac desktop using Übersicht.

Notifications You must be signed in to change notification settings

Makiah/WunderlistTasksWidget

Repository files navigation

Wunderlist Tasks Widget

I find it very helpful to see upcoming tasks and events right on my desktop, visible with a trackpad swipe, or by minimizing the current window. Unfortunately, Wunderlist doesn't currently have this functionality, until you use this!

Installation Procedure

There are a couple things you'll need first.

  • macOS 10.11 - 10.13
  • Übersicht — a widget manager for macOS, which is used to render the tasks.
  • NodeJS — parses task JSON and completes the Wunderlist OAuth procedure. I suggest you install via Brew, a package manager for macOS. This app uses 8.9.0, but any node version should work (just change run.sh).

Once they're installed, download the latest release and extract it to the Übersicht widgets folder.  Then open Übersicht, and you should get a screen that looks like this:

If you log in, this app should complete the OAuth flow and close the tab, then display your tasks. If you experience a bug, please report it to the Issues page.

Note that if you want to git clone this code, you'll have to also install NPM and run npm install in /lib/oauthserver and /lib/datadisplay to get the node_modules directories.

Configurable Features

Use the customization.json file if you need to change settings from the default.

{
    "positioning": {
        "left-offset-percentage": 59, 
        "top-offset-percentage": 5, 
        "width-percentage": 32.5, 
        "height-percentage": 90 
    }, 
    "lists-to-display": [
        "My First List", 
        "My Second List", 
        "Leave this array empty if you want to include all lists"
    ], 
    "urgency-filters": {
        "display-tasks-without-due-date": true,
        "display-tasks-due-within-x-days": 7
    }
}

Disclaimer: I haven't done a lot to make this code super secure: the Wunderlist access token is obtained by querying the local server, and I also store the token in plain text currently. If you use Wunderlist for secure work stuff then don't use this unless you're certain there's no risk of being hijacked (I'm a student, the worse thing that could happen is someone delete my test reminder, which would take approximately 5 seconds to put back).