Todo Archive Plugin for Joplin

中文版

Overview

This plugin allows you to archive completed todo items from your notes into a separate archive note. It helps keep your todo lists clean and organized while preserving a record of completed tasks.

Features

• Archive completed todo items with a single command
• Automatically creates an archive note (named [original-note-name]-archive) in the same notebook
• Preserves the structure of todo items including sub-items and notes
• Adds timestamped sections in the archive note for easy tracking
• Accessible via menu item or keyboard shortcut

Installation

To install the Joplin plugin from a .jpl file, follow these steps:

1. Download the plugin file: Visit the plugin's GitHub repository page and download the .jpl file for the desired plugin.
2. Open Joplin: Launch the Joplin application.
3. Access plugin management: Click on the "Tools" menu, select "Options", and then choose the "Plugins" tab in the opened window. On macOS, the path is: Preferences -> Plugins
4. Install the plugin: Click "Manage Your Plugins", select "Install from File", and in the file selection dialog that appears, locate and select the previously downloaded .jpl file to install it.
5. Restart Joplin: After installation is complete, restart the Joplin application for the plugin to take effect.

Usage

1. Open a note containing todo items
2. Make sure you have some completed todos (marked with [x])
3. Use one of the following methods to archive:
   • Go to Note > Archive Completed Todos in the menu
   • Go to Tools > Archive Completed Todos in the menu
   • Use the keyboard shortcut Cmd/Ctrl + Shift + A
4. The completed todos will be moved to an archive note named [original-note-name]-archive
5. Each archiving session is timestamped in the archive note

How It Works

1. The plugin identifies completed todo items (those marked with [x])
2. It preserves the complete structure of each todo item, including any sub-items or notes
3. It creates or updates an archive note in the same notebook
4. Completed todos are removed from the original note and added to the archive note
5. Archive notes are organized by timestamp for easy reference

Keyboard Shortcut

• Cmd/Ctrl + Shift + A - Archive completed todos

Requirements

• Joplin version 3.3 or higher

Support

If you encounter any issues or have suggestions for improvement, please open an issue on GitHub.