A native macOS menu-bar app that syncs your Obsidian tasks
to Apple Reminders, Things 3, Todoist, or TickTick.

Free and open source. If it saves you time, consider buying me a coffee!

---

What it does

Your vault is the source of truth. Remindian syncs tasks from Obsidian into your chosen destination. Completions, due dates, start dates, priority, and tags sync back with surgical, metadata-preserving edits.

Two task sources — Obsidian Tasks plugin format and TaskNotes plugin

Four destinations — Apple Reminders · Things 3 · Todoist · TickTick

Download

Download Remindian v4.1.0 — Universal Binary (Apple Silicon + Intel), macOS 13.0+

Since the app is not notarized yet, right-click the app and select Open on first launch to bypass Gatekeeper. Remindian includes a built-in auto-updater that checks for new versions on launch and every 24 hours.

Features

🔄 Sync Two-way sync — Completions, dates, priority, tags sync back Surgical file edits — Never reconstructs task lines Recurrence support — Creates next occurrence automatically Real-time sync — File watcher triggers on vault changes Safety abort — Protects against vault unmount/scan failures Dry run mode — Preview changes without modifying anything	🗂️ Organization Tag-based list mapping — #work → "Work" list File-to-list mapping — Map entire files to lists Project/context routing — TaskNotes field-based routing Folder filtering — Whitelist or exclude vault folders Cross-file deduplication — Syncs only one copy Configurable field mapping — Remap YAML field names
📥 Sources Obsidian Tasks — - [ ] task 📅 2024-01-20 #tag TaskNotes — One YAML file per task (CLI/Files/HTTP) Custom status mapping — done, shipped, archived	📤 Destinations Apple Reminders — via EventKit Things 3 — via AppleScript + URL scheme Todoist — via REST API + token auth TickTick — via Open API + OAuth 2.0

Also includes: Auto-updater · Onboarding wizard · Global hotkey · GoodTask tag writeback · New task writeback to Obsidian inbox · Automatic file backups · Launch at login · macOS native (SwiftUI, no dependencies)

Quick Start

1. Download the DMG from the latest release
2. Drag Remindian to your Applications folder
3. Right-click → Open on first launch (required for unsigned apps)
4. Follow the onboarding wizard to select your vault, grant access, and configure mappings
5. Tasks start syncing automatically

Configuration

Open Settings from the menu bar icon:

Tab	What it configures
General	Source & destination, vault path, sync interval, writeback toggles, notifications, default list, hotkey
List Mappings	Tag → list mappings, file → list mappings
TaskNotes	Integration mode, status mapping, field mapping, list/folder source
Advanced	Folder filtering, Reminders list filtering, dry run, sync state reset, global filter

How It Works

Obsidian Tasks (default)

- [ ] My task ⏫ 🛫 2024-01-15 📅 2024-01-20 #work
- [x] Completed task 📅 2024-01-10 ✅ 2024-01-09
- [ ] Recurring task 🔁 every week 📅 2024-03-01

TaskNotes

---
title: My task
status: open
priority: high
due: 2024-01-20
tags: [work]
project: "[[My Project]]"
---

Each task syncs with its due date, priority, and tags. Completions are written back as surgical edits — only the checkbox and completion date are modified.

Build from Source

git clone https://github.com/Santofer/Remindian.git
cd Remindian
open ObsidianRemindersSync.xcodeproj

Requirements: macOS 13.0+, Xcode 15.0+. Builds a Universal Binary by default.

Transparency

AI (Claude) was used as a development tool. All code is reviewed, tested on real data, and the full source is open for audit. The app is sandboxed, creates automatic backups, and includes dry run mode.

License

MIT License — Made by Santofer

CHANGELOG · CONTRIBUTING