habitica-sync/README.md

40 lines
2.1 KiB
Markdown
Raw Normal View History

2021-10-17 18:18:08 -06:00
# Habitica Sync in Obsidian
2021-10-16 09:08:30 -07:00
This plugin for Obsidian incorporates a view to display and interact with the task management app Habitica.
2021-10-23 14:54:50 -06:00
Please open issues for any bugs/functionality requests :)
2021-10-16 09:08:30 -07:00
## Usage
2021-10-23 14:54:50 -06:00
The plugin's view is enabled by clicking on the "Open Habitica Pane" option in the side ribbon (default hotkey is `Ctrl+Shift+H`).
To sync your Habitica account, go to the settings page of the plugin and enter your user ID and API token credentials.
2021-10-16 09:08:30 -07:00
## Features
2021-10-23 14:54:50 -06:00
### Pane View
[![Image from Gyazo](https://i.gyazo.com/4266d01941e71fef41819ea8a6b6592e.png)](https://gyazo.com/4266d01941e71fef41819ea8a6b6592e)
[![Image from Gyazo](https://i.gyazo.com/697a58b8e7ffd3df86a2944b6abbaa92.png)](https://gyazo.com/697a58b8e7ffd3df86a2944b6abbaa92)
2021-11-21 02:14:41 -06:00
- View stats (HP, XP, coins)
- View to do's, dailies, and habits
- Tab for active/completed tasks and dailies
2021-10-23 14:54:50 -06:00
#### Check off tasks/dailies in the view, modify habit counters (+/-)
[![Image from Gyazo](https://i.gyazo.com/5759e12bc5267711c5e03485a6d72c2f.gif)](https://gyazo.com/5759e12bc5267711c5e03485a6d72c2f)
- Can uncheck completed habits/todos as shown above
2021-10-16 09:08:30 -07:00
## Settings
2021-11-21 02:14:41 -06:00
The following two inputs help fetch your user data to be displayed in the Obsidian view:
2021-10-16 09:08:30 -07:00
- **Habitica User ID:** You can find this by clicking on the "User" icon in the top right of the Habitica webapp, "Settings", then "API"
- **Habitica Token API:** You can find this by clicking on the "User" icon in the top right of the Habitica webapp, "Settings", then "API"
2022-01-15 09:51:09 +05:30
- **Show Task Descriptions:** Toggles whether description/notes for tasks will be shown or not
- **Due date format:** Format in which the due date is displayed
- **Show Checklist items:** Toggles the checklist items for a task.
2021-11-21 02:14:41 -06:00
2021-10-17 05:51:51 -07:00
## Roadmap
2021-10-17 18:18:08 -06:00
We will be implementing additional features including:
- Add/delete/customize tasks and habits
2021-10-19 21:40:28 -06:00
2021-10-23 14:54:50 -06:00
*Feel free to support us and donate!*
2021-10-19 21:40:28 -06:00
<a href='https://ko-fi.com/leonardandran' target='_blank'><img height='35' style='border:0px;height:46px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='Buy Me a Coffee at ko-fi.com' />
2021-11-21 02:14:41 -06:00