Skip to content

TimeOtter

Execute commands based on your Google Calendar events. Set it once, forget forever.

Why TimeOtter?

Calendar-Driven

Schedule tasks using your existing Google Calendar. Create an event, TimeOtter runs your command.

Set and Forget

Run as a cron job and let TimeOtter handle the rest. No manual intervention needed.

Flexible Commands

Execute any shell command - play a video, send a notification, run a script.

Minimal Config

Just a few lines in config.toml and you’re ready to go.

Quick Example

~/.config/timeotter/config.toml
CalendarID = "your-email@gmail.com"
CmdToExec = "mpv ~/alarm.mp3"
TokenFile = "~/.cal-token.json"

Create a calendar event, and TimeOtter will run your command when it triggers.