Todoman Reminder Sync for Fastmail

productivity, ubuntu, fastmail

How to configure calendar sync on Linux (tested on Ubuntu 20.04) for Fastmail using vdirsync and todoman.

This lets me use the same todo list between my linux desktop, and iOS mobile devices (using the built in stock reminders app)

Vdirsyncer Config #

I am using vdirsyncer to connect to Fastmail’s servers and before the synchronisation.

status_path = "~/.vdirsyncer/status/"
[pair fastmail]
a = "local"
b = "cal"
collections = ["from a", "from b"]
[storage cal]
type = "caldav"
url = ""
username = ""
password = "fastmail-app-specific-password"
[storage local]
type = "filesystem"
path = "~/.vdirsyncer/fastmail"
fileext = ".ics"

Todoman #

Todoman is a terminal reminder/todo app that can work with vdirsyncer.

todoman.png Todoman Output in Terminal

Here is my configuration for todoman that points it at the folders created by vdirsyncer.

# A glob expression which matches all directories relevant
path = ~/.vdirsyncer/fastmail/path-for-reminders-cal
date_format = %Y-%m-%d
time_format = %H:%M
default_list = reminders-cal-id (same as the folder, see below...)
default_due = 48
humanize = true

To figure out which calendar is the ical reminders feed you can take a look in ~/.vdirsyncer/fastmail. There should be a folder for each of your Fastmail calenders.

Look through the ICS files that you find and you’ll find something similar to the this example. You want to use the directory name of the folder that contains your VTODO’s - use the directory name for the default_list above as well.

PRODID:-//Apple Inc.//iOS 13.6.1//EN
SUMMARY:Test from ios  

Calendar Support #

It is possible to using a terminal calendar tool like Calcurse or Khal but I have not set these up yet.

Automating with Cron #

To automate synchronisation, I used cron. Add the following via crontab -e to run the sync every 15 minutes.

*/15 * * * * /home/james/.local/bin/vdirsyncer sync > /dev/null

Leave a Comment

I'd love to hear from you! Use the button below to email me with any thoughts, or feedback (and if you'd like your comment published or not).

Your email address won't be used for any other purpose than replying.