Mirrors/super-productivity
1
0
Fork 0
mirror of https://github.com/johannesjo/super-productivity.git synced 2026-01-23 02:36:05 +00:00
Code Issues Projects Releases Wiki Activity

document CalDAV status

Browse source
This commit is contained in:
RayBB 2025-01-10 16:34:12 -05:00 • committed by Johannes Millan
parent f56b5c584a
commit 5603fe272a
2 changed files with 53 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
README.md
View file

@ -104,6 +104,7 @@
- Need some extra focus? A **Pomodoro timer** is also always at hand.
- **Collect personal metrics** to see, which of your work routines need adjustments.
- Integrate with **Jira**, **GitHub**, **GitLab**, **Gitea** and **OpenProject**. Auto import tasks assigned to you, plan the details locally, automatically create work logs, and get notified immediately, when something changes.
- Basic [**CalDAV**](https://github.com/johannesjo/super-productivity/blob/master/docs/caldav.md) integration.
- Back up and synchronize your data across multiple devices with **Dropbox** and **WebDAV** support
- Attach context information to tasks and projects. Create **notes**, attach **files** or create **project-level bookmarks** for links, files, and even commands.
- Super Productivity **respects your privacy** and **does NOT collect any data** and there are no user accounts or registration. **You decide where you store your data!**

52
docs/caldav.md Normal file
View file

@ -0,0 +1,52 @@
# CalDAV Features and Roadmap
## Overview
Super Productivity offers basic CalDAV integration for importing and syncing tasks. This document outlines the current capabilities and limitations of the integration. If you're a developer and would like to improve the integration help would be very welcome.
## Feature Support Matrix
| Feature | Import | Sync SP → CalDAV | Sync CalDAV → SP |
|---------|---------|------------------|------------------|
| Title | ✅ | ❌ | ❌ |
| Description | ✅ | ❌ | ❌ |
| Tags | ✅ | ❌ | ❌ |
| Complete/Incomplete Status | ✅ | ✅* | ❌ |
| New Tasks | ✅ | ❌ [^3017] | ✅* |
| Subtasks | ✅ [^2876] | ❌ | ❌ |
| Deleted Tasks | ❌ | ❌ | ❌ [^2915]|
| Start Date | ❌ | ❌ | ❌ |
| Due Date | ❌ | ❌ | ❌ |
| Attachments | ❌ | ❌ | ❌ |
| Recurrence Rules | ❌ | ❌ | ❌ |
| Created Time | ❌ | ❌ | ❌ |
| Last Modified Time | ❌ | ❌ | ❌ |
| Status (Needs Action, In Progress, Cancelled) | ❌ | ❌ | ❌ |
| Priority | ❌ | ❌ | ❌ |
*Requires enabling in advanced configuration
## Current Features
### Advanced Config Options
- Auto import to Default Project (configurable per calendar)
- Poll imported for changes and notify (only supports new tasks, see above table)
- Automatically complete CalDAV todos on task completion
## Limitations
### Configuration Restrictions
- Each CalDAV calendar/list requires a separate configuration
- Cannot import from multiple calendars with a single configuration
## Future Development
### Note on Integration Roadmap
As [stated](https://github.com/johannesjo/super-productivity/issues/3017#issuecomment-2577469193) by the repository maintainer in Jan 2025:
> "It's important to understand that this will always be limited since CalDAV is likely not completely mappable to the model of Super Productivity. First step for this would be a feasibility analysis to check what parts of the model can be mapped and which not. Next step would be making a concept how this all could work."
Source: [Issue #3017 Comment](https://github.com/johannesjo/super-productivity/issues/3017#issuecomment-2577469193)
## Related Issues
[^2876]: [Import Multilevel Subtasks from CalDAV](https://github.com/johannesjo/super-productivity/issues/2876)
[^2915]: [CalDav task status and deleted tasks are not updated](https://github.com/johannesjo/super-productivity/issues/2915)
[^3017]: [Unable to upload new local tasks to CalDav](https://github.com/johannesjo/super-productivity/issues/3017)