Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

OpenTodo

pixaripixariOpenTodo41 downloads

Send lines from any note to your own OpenTodo server as tasks that link back to the note, and keep a folder of task files in two-way sync. Works offline and with encrypted accounts.

Add to Obsidian
OpenTodo screenshot
OpenTodo screenshot
OpenTodo screenshot
OpenTodo screenshot
OpenTodo screenshot
OpenTodo screenshot
OpenTodo screenshot
  • Overview
  • Scorecard
  • Updates13

Send a line, or a selection of lines, from any note to your own OpenTodo server as tasks, and keep a folder of task files in two-way sync with it. Each task sent links back to the note it came from, and the line gets a link to the task. It works on Obsidian for desktop and mobile, offline, and with end-to-end encrypted accounts.

  • Send line to OpenTodo in the editor's context menu, or OpenTodo: Send line as a task in the command palette and the mobile toolbar. With no selection it sends the line at the cursor; with a selection, each non-empty line (at most 50). The plugin sets no hotkeys.
  • Two grammars. A checkbox line (- [ ] Renew passport 📅 2026-11-05 ⏫ #errand) is read like the Tasks plugin and OpenTodo's vault: due date, start date, priority, #tags as labels, [time:: 09:00], [estimate:: 45m], [deadline:: …]. Any other line is read like OpenTodo's quick add: Call the plumber tomorrow 9am p2 #Home @errand.
  • A sheet before sending shows the title, what was recognised (each chip can be removed) and the project. Enter sends, Escape cancels. "Send without asking" skips it.
  • After sending the line gains [opentodo:: https://your-server/?task=…] (or, by setting, is ticked or removed). "Undo" in the notice for ten seconds puts the line back and moves the task to OpenTodo's Trash. A line that already carries the link is never sent twice.
  • The task links back: its origin is obsidian://open?vault=…&file=…, so the chip on the task opens the note. Renaming or moving the note in Obsidian updates the links; "Fix task links in this note" repairs links after a rename made elsewhere.
  • Offline: tasks wait on the device and are sent when OpenTodo can be reached (on start, when the network returns, every minute, or with "Send pending tasks").
  • Encrypted accounts: titles, notes and origins are encrypted on the device with OpenTodo's own code before they are queued; the passphrase unlocks the account key for the session ("Remember on this device" keeps it).
  • Sync a folder: one folder of the vault (default OpenTodo/) in two-way sync with OpenTodo, with the files and rules of ot vault: one file per project, one Tasks line per task, .opentodo/state.json. It syncs when the plugin starts, a second after a file in the folder changes, every 30 seconds while Obsidian is in front and with "Sync folder now"; never in the background. A folder that Obsidian Sync, iCloud or git copies to several devices is synced by one of them; the others show which and offer "Take over syncing here".

Requirements

  • An OpenTodo account. The plugin works with an OpenTodo server, which you run yourself (or someone runs for you): OpenTodo is free, open-source (AGPL-3.0) software, and the plugin does nothing until it is connected to one. Nothing is paid, and no account with anyone else is needed.
  • OpenTodo 0.19.1 or newer on the server, and Obsidian 1.8.7 or newer, on desktop or mobile.

Connect

  1. In OpenTodo, open Settings → Integrations → API tokens and create a token with the scope Full, named after the device (for example "Obsidian on my phone"). The plugin needs a full API token because it writes tasks: a read token cannot write, and an agent token is meant for AI assistants and labels changes as theirs.
  2. In Obsidian, open Settings → Community plugins → OpenTodo, enter the server address (todo.example.com) and paste the token, then pick Connect.

The token is kept in Obsidian's storage on this device, never in the plugin's data.json inside the vault, so a vault synced to another device (Obsidian Sync, iCloud, git) does not carry it: connect each device with its own token, and revoke one without touching the others. Disconnect removes the token, the cached projects and labels and any remembered key from the device.

Network use and privacy

The plugin makes no request until you connect it. It then connects only to the OpenTodo server you configure, through Obsidian's own request function, for these routes: /healthz (the server's version), /api/v1/me, /api/v1/projects, /api/v1/labels, /api/v1/tasks/{id} (the project of a linked task, after a rename on an encrypted account), /api/v1/encryption/keys (the wrapped key record of an encrypted account) and /api/v1/sync (sending tasks, and the folder sync's exchange as a vault device vault:<id>). Addresses must be https; plain http is accepted only for this device and private networks, after a warning. With folder sync on, it reads and writes only the folder you pick (and its .opentodo/ state); it never touches files outside the vault.

It collects nothing: no analytics, no crash reports, no update check of its own (Obsidian updates plugins), no other destination. What it sends to your server is the tasks you send, the changes to their links and, with folder sync on, the changes made in the synced folder.

Install

  • From Obsidian: Settings → Community plugins → Browse → "OpenTodo", once the plugin is listed in the directory.
  • By hand: download main.js, manifest.json and styles.css from the latest release of OpenTodoApp/obsidian-opentodo into <vault>/.obsidian/plugins/opentodo/, then enable "OpenTodo" in Settings → Community plugins.
  • With BRAT: add the beta plugin OpenTodoApp/obsidian-opentodo.

The guide is docs/obsidian.md in the OpenTodo repository.

Development

The source lives in obsidian/ of the OpenTodo repository. Each release copies it into the release repository, OpenTodoApp/obsidian-opentodo, together with the shared web modules it bundles (web/src/…), in the same layout: npm ci && npm run build there rebuilds main.js and styles.css byte for byte. Report issues in either repository; changes are made in OpenTodo. The plugin bundles OpenTodo's own quick-add parser (web/src/lib/nlp), envelope code (web/src/lib/crypto.ts, web/src/lib/e2eeEnvelope.ts) and clock (web/src/lib/hlc.ts), and the TypeScript twin of the vault (src/vault/: the task-line grammar, pinned with internal/vault by internal/vault/testdata/lines.vectors.json, and the sync engine, pinned by the step-by-step sync vectors in internal/vault/testdata/sync/ that go test ./internal/vault -run TestSyncVectors -update writes from the Go engine), so the shared vectors pin the plugin too.

  • make obsidian: type-check, unit tests (web/'s vitest and happy-dom, with an in-memory obsidian module), and the build of obsidian/dist/, which fails when main.js is over 400 KB (258 KB with the vault engine) or needs a Node or Electron module (Obsidian mobile has neither).
  • make obsidian-e2e: the plugin against bin/opentodo (make build first).
  • make obsidian-review: the checks of Obsidian's community directory on what the release repository receives: it fills a folder as the release does, runs npm ci, npm audit and npm run build there and compares the result with obsidian/dist, type-checks it, and lints it with Obsidian's own rules (eslint-plugin-obsidianmd), failing on any error (review/).
  • cd obsidian && node esbuild.config.mjs --watch, with obsidian/dist linked into a test vault's .obsidian/plugins/opentodo.

Dependencies: none at run time. Build time: obsidian (the API's types) and esbuild, pinned in package.json.

The plugin's strings are in locales/ in the six languages OpenTodo ships, follow Obsidian's language and are checked by make i18n-check.

Manual runs of the folder sync

The unit tests and make obsidian-e2e run the engine and the plugin against stand-ins and a real server; these runs on real devices are recorded here (obsidian-vault-sync task 5.3).

Run Device and sync service Date Result
Turn on, tick a line, see it done in the app; a task made in the app appears within 30 s iPhone, vault in iCloud Drive not yet run
A file iCloud has not downloaded is skipped, then merged once it arrives iPhone, vault in iCloud Drive not yet run
Same folder on two devices: the second shows "Synced by …", then takes over Android with Obsidian Sync, and a laptop with ot vault watch not yet run
A folder moved from ot vault to the plugin and back (--take-over both ways) laptop not yet run

Releases

Every OpenTodo release (v0.20.0) publishes the plugin with the same version (0.20.0): CI builds it from the tag and pushes manifest.json, main.js, styles.css, versions.json, this README, the licence and the source the bundle is built from (obsidian/, web/src/…, package.json, package-lock.json, tsconfig.json) to OpenTodoApp/obsidian-opentodo with a tag equal to the version, and that repository's workflow attaches the three files to a release (mirror/release.yml). The push uses the deploy key in the OBSIDIAN_DEPLOY_KEY secret; without it the job prints the manual steps and succeeds. By hand: node obsidian/scripts/mirror.mjs 0.20.0 <checkout> after make obsidian.

The community directory. Plugins are submitted at community.obsidian.md (Obsidian stopped taking pull requests to obsidianmd/obsidian-releases in May 2026; its community-plugins.json is now copied from the directory). After the first release exists in the release repository, a maintainer signs in there with an Obsidian account linked to GitHub, adds the plugin with the repository https://github.com/OpenTodoApp/obsidian-opentodo and the owner OpenTodoApp, and fixes anything the automated review reports. What to enter, and the checklist, are in store/submission.md. Once published, the directory's entry reads:

{
  "id": "opentodo",
  "name": "OpenTodo",
  "author": "OpenTodo",
  "description": "Send lines from any note to your own OpenTodo server as tasks that link back to the note, and keep a folder of task files in two-way sync. Works offline and with encrypted accounts.",
  "repo": "OpenTodoApp/obsidian-opentodo"
}

Until it is listed, the plugin installs by hand or with BRAT.

Licence

AGPL-3.0-only, like OpenTodo: the plugin bundles OpenTodo's own code. See LICENSE.

HealthExcellent
ReviewSatisfactory
About
OpenTodo is a free, open-source, self-hosted task manager. This plugin connects Obsidian to your own OpenTodo server. Put the cursor on a line (or select several) and pick "Send line to OpenTodo": each line becomes a task, read like the Tasks plugin for checkbox lines (dates, priority, tags) or like OpenTodo's quick add for any other line ("Call the plumber tomorrow 9am p2 #Home"). The task links back to the note, and the line gets a link to the task. Optionally, one folder of the vault stays in two-way sync with OpenTodo as Markdown task files, on phones too. Works offline (tasks wait on the device), with end-to-end encrypted accounts, in six languages, on desktop and mobile. It talks only to the server you configure and collects nothing. Requires an OpenTodo account on a server you run or use.
TasksSyncingLinks
Details
Current version
1.5.0
Last updated
4 days ago
Created
3 weeks ago
Updates
13 releases
Downloads
41
Compatible with
Obsidian 1.8.7+
Platforms
Desktop, Mobile
License
AGPL-3.0
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
GitHub Sponsors
Authors
pixaripixari
GitHubpixari
OpenTodoopentodo
open-todo.app
Xopentodoapp
Threadspixari83
  1. Community
  2. Plugins
  3. Tasks
  4. OpenTodo

Related plugins

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Smart Connections

Find related notes and excerpts while writing. Your AI link building copilot displays relevant content in graph + list view. A local embedding model powers semantic search. Zero setup. No API key.

Self-hosted LiveSync

Sync vaults securely to self-hosted servers or WEBRTC.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Advanced URI

Control everything with URI.

Fast Note Sync

Real-time sync of your vaults across server, mobile, and web; shareable with anyone; supports REST and MCP integrations to build your personal AI knowledge base.

Tasks

Track tasks across your vault. Supports due dates, recurring tasks, done dates, sub-set of checklist items, and filtering. Maintained by Clare Macrae and Ilyas Landikov, created by Martin Schenck.

Operon

Task and project management system that unifies inline tasks and file-based tasks in the same workflows with Tables, Filters, Calendars, Kanban boards, Gantt views, Canvas, and time tracking.

Find orphaned files and broken links

Find files that are not linked anywhere and would otherwise be lost in your vault. In other words: files with no backlinks.