TickTickSync

The TickTickSync plugin automatically creates tasks in ticktick and synchronizes task state between Obsidian and ticktick.

The plugin works best when the Tasks plugin is installed.

Features

Any task created in Obsidian and tagged with #ticktick will be synchronized with TickTick
Any task created in TickTick will be synchronized to Obisidian.
Updates are bi-directional
Tasks added or updated from Obsidian are synched to TickTick immediately.
Tasks added or updated from TickTick are synched on a configurable time interval.

Notes

All Task Deletion operations must be confirmed. In the fullness of time, when we get out of Beta, this might be a preference item. For now it's compulsory.
TickTick lists are referred to as Projects in the plugin, and throughout documentation.
TickTick only has four priorities (High, Medium, Low, None). Please see Priority in Task Format for Task mapping of priority
Warning: TickTickSync automatically creates .md files corresponding with the lists/projects created in TickTick and downloads all tasks to them.
If the files are deleted in Obsidian while the TickTickSync plugin is active, those tasks will be deleted. If you accidentally confirm that deletion: To recover those tasks, go to the "Trash" menu item on the TickTick interface and recover deleted tasks from there.
TickTickSync now supports Task Items and will NOT delete Task Content. However, as of now, it will not allow management of Task Content.
A link to the containing file in Obsidian is added to the Task Title in TickTick, but the content field is not mangled. In the fullness of time content will be manageable in TickTickSync. Please watch this issue for progress.
Relatively confident that Time Zone difference issues are resolved. If not: Please open an issue with details.
It is now possible control synchronization. Please see details here.
TickTick has changed sign in procedures. You will have to login manually from settings.

Known Issues

The plugin only works with the Tasks emoji formats. It will not work with the Dataview format. In the fullness of time, this plugin will be refactored to use Tasks functionality to support both.
Due Date:
1. On the Obsidian side: if no time is provided, the start time will default to 08:00
2. On the TickTick side: if not time is provided, the start time will be 00:00
3. The Tasks plugin queries will not find TickTickSync Tasks because the dates are not positioned per Tasks Format
Parent/Child tasks are supported bi-directionally. However, changes to the parent/child relationship are not handled. Yet.
Moving tasks between Projects/Lists is NOT supported at this time.
Because Tags can't have spaces, at this time it is not possible to add a task to a project with name that contains spaces. In the fullness of time, will implement some kind of workaround (eg: #folder_with_a_space will be converted to folder with a space)
If a file has a default project association (see settings), it is possible to create a task with a project tag other than the default project. The Task will be correctly synched to TickTick in the correct project. However, if the Task is then updated with subtasks, from TickTick, the subtasks will be synched to the project's default file rather than the file where the original parent task was created.

Installation

From within Obsidian

From Obsidian v1.3.5+, you can activate this plugin within Obsidian by doing the following:

Open Obsidian's Settings window
Select the Community plugins tab on the left
Make sure Restricted mode is off
Click Browse next to Community Plugins
Search for and click on TickTickSync
Click Install
Once installed, close the Community Plugins window
Under Installed Plugins, activate the TickTickSync plugin

You can update the plugin following the same procedure, clicking Update instead of Install

BRAT

Install from Community Plugins Obsidian42 - BRAT (latest)
- See their readme.
Follow the instructions to add the plugin from: https://github.com/thesamim/TickTickSync

Manually

If you would rather install the plugin manually, you can do the following:

Download the latest release of the plugin from the Releases page.
Extract the downloaded zip file and copy the entire folder to your Obsidian plugins directory.
Enable the plugin in the Obsidian settings.

Documentation

Please see Documentation in the Wiki.

Acknowledgements

This plugin is based on Ultimate Todoist Sync for Obsidian.
There have been significant changes due to the difference between TickTick and ToDoist task handling. I am grateful for the work that HeroBlackInk put it in to the original plugin.

The TickTick api wrapper used here is forked from https://github.com/lucasvtiradentes/ticktick-api-lvt. Thanks to Lucas for his support.

Thanks to quanru for his work in enabling Dida support in TickTick api wrapper and for helping with Dida testing.

Thanks to anschein for helping with Dida testing.

Disclaimer

This plugin was built with the author's specific use cases in mind. Additional use cases can and will be considered.

The author makes no representations or warranties of any kind, express or implied, about the accuracy, completeness, or usefulness of this plugin and shall not be liable for any losses or damages resulting from the use of this plugin.

The author shall not be responsible for any loss or damage, including but not limited to data loss, system crashes, computer damage, or any other form of loss arising from software problems or errors. Users assume all risks and are solely responsible for any consequences resulting from the use of this product.

By using this plugin, you agree to be bound by all the terms of this disclaimer. If you have any questions, please contact the author.

Contributing

Contributions are welcome! If you'd like to contribute to the plugin, please feel free to submit a pull request.

License

This plugin is released under the GNU GPLv3 License.

quanru / TickTickSync