Skip to content

royxue/obsidian-things3-sync

Repository files navigation

Things3 Sync

A cross-platform Obsidian plugin for syncing todos (as well as tags, dates) between Obsidian and Things3 (with multi-language support).

Features

  • Cross-Platform: Works on both macOS and iOS
  • Multiple Languages: Use any language when creating todos
  • Todo Tags: You can enter tags after your todo text, or via the default tags in the settings
  • Date Capture: If the Obsidian note includes a date, it will be included when creating the todo in Things3.

Usage

Creating A Todo

create

  • Select the line of the todo

  • Using cmd + p and run the Things3 Sync: Create Todo

  • Note: The tags feature currently only supports tags that already exist in Things3. To add a new tag, you'll need to first create it in Things3, and then you will be able to use it in this plugin.

Toggling a Todo's Status

  • Select the line of the todo

  • Using cmd + P and run the Things3 Sync: Toggle Todo

  • The status of the todo will be toggled in both Obsidian and Things3

Pro Tip: This feature can be assigned a hotkey for faster, more convenient toggling.

Creating a Todo from a Note

You can create a Things3 todo from an Obsidian note. This plugin will automatically include a backlink to the Obisidian note in the todo in Things3

Roadmap

  • Multiple Markdown elements support.

  • Permanent URL support.

  • Better tags support.

  • Better toggle trigger method. Not (currently) possible due to a limitation in the Things3 API

  • Multi-line support. Not (currently) possible due to a communication limitation between Things3 and Obsidian

  • Obsidian Note to Things3 Todo

Security

This plugin requires an authentication token from Things3 in order to sync data between Obsidian and Things3. That auth token will be stored in plain-text inside your Obsidian vault's plugin folder (e.g., ./obsidian/plugins/obsidian-things3-sync). As a result, you should be cautious when syncing or sharing the settings for this plugin.

Feature Requests/Feedback

Both feature requests and feedback are welcome. Please feel free to submit an issue for either ;)

Thanks a lot.

Attribution

The folliwng repositories offered great help during the development of this plugin:

Buy me a coffee

Buy Me A Coffee