Hi everyone. I wanted to share an app that I’ve written in Swift that will sync Taskpaper tasks into Things.
Here’s why I did this.
Taskpaper is great for keeping track of projects and tasks. But it’s not so great on mobile. With a big Taskpaper file it’s difficult to quickly see what I need to do today. I wanted a way so that if a task is marked as @due, I am reminded on my phone that it is due. Same thing for @start and @today/@flag.
So using Jesse’s open source Swift Taskpaper framework (https://github.com/jessegrosjean/BirchOutline), and Things (which has great Applescript support) I’ve written an app that will sync tasks from a Taskpaper file into Things.
Here’s how to use it:
The app will only sync the tasks with the following tags:
@flag
@due
@today
@start
Flag and Today tagged tasks will show up as “Today” in Things.
Due tagged tasks will be added to Things with a due date. (and show up in today on the due date)
Start tagged tasks will be scheduled for their start date in Things. (and show up in today on the due date)
Completing tasks in either Taskpaper or Things will mark them complete between the two.
However, making any changes in Things (other than completing) will not sync back to Taskpaper. This app is designed so that Taskpaper is the source of truth. Things is simply a way to quickly look at what is today, due, and scheduled.
So sync is 1 direction from Taskpaper to Things (except for marking things as complete which will go both ways).
Format
For @due and @start they need to have dates with format of (YYYY-MM-DD)
Example:
@start(2016-12-03)
@due(2016-12-03)
IMPORTANT: Things needs to have an Area called “Taskpaper”. Thats where all the tasks will be synced to. If the area doesn’t exist the app will not work.
Sync
You can either sync manually by clicking the sync button.
Or, by default, the app will sync every 30 minutes. To change this edit the Repeat Sync field. (in minutes)
Usage
- In Things, create a new Area called “Taskpaper”
- Run the TPThingsSync app
- Click Pick File and select the taskpaper file you’d like to sync with Things
- Click sync
How to get
I’ve open sourced the code so everyone can check out what’s going on and how you may want to improve for your own workflow. You can find it here: GitHub - ahlager/TPThingsSync: Sync tasks between Taskpaper and Things
Or, if you’d like to download the app and run it the link is here: Dropbox - TPThingsSync - Simplify your life