Skip to content

jsifalda/obsidian-todos-sort

 
 

Repository files navigation

Todos Sort Plugin

A plugin for Obsidian that sorts todos by completion status within a note.

Ever wanted to sort your todos by completion status when you open a note? Well, this Obsidian plugin is here to help you! This plugin automatically sorts todos in your notes based on their completion status, making it easier to manage and prioritise your tasks (only on file open - not for every single note edit)

obsidian-todos-sorter.mov

Features

  • Automatic Sorting: Automatically sorts todos in your notes whenever a file is opened.
  • Customizable Sort Order: Choose whether completed tasks appear at the top or bottom of your list.
  • Efficient Performance: Optimized to handle large notes with minimal performance impact.
  • User-Friendly Settings: Easily configure the plugin settings through the Obsidian settings tab.

Installation

  1. Browse to the "Community Plugins" section in your Obsidian settings.
  2. Search for "Todos Sort".
  3. Click "Install", then "Enable".

(Or install plugin directly from this link: Todos Sort)

Usage

Once installed and enabled, the plugin will automatically sort todos in your notes based on the selected sort order. You can configure the sort order in the plugin settings:

  1. Open the Obsidian settings.
  2. Navigate to the "Todos Sort" tab.
  3. Choose your preferred sort order:
    • Completed at top: Completed tasks will appear at the top of the list.
    • Completed at bottom: Completed tasks will appear at the bottom of the list.

Development

To contribute to the development of this plugin, follow these steps:

  1. Clone the repository: git clone https://github.com/jsifalda/obsidian-todos-sort.git
  2. Install dependencies: yarn install
  3. Build the plugin: yarn run build
  4. Test your changes: yarn run test

Release Process

To release a new version of the plugin:

  1. Make and commit your changes.
  2. Tag the release: git tag x.x.x
  3. Push the tags: git push origin --tags

License

This project is licensed under the MIT License. See the LICENSE file for details.

Support the Project

If you find this plugin valuable, consider supporting its development, because it helps me a lot!

Buy Me A Coffee

Follow me on X/Twitter @jsifalda for updates and announcements! Your support helps maintain and improve this plugin. Every contribution is appreciated and makes a difference. Thank you for your support!

Acknowledgments

  • Developed by @jsifalda (forked version of Ryan Gomba)
  • Inspired by the need for better task management within Obsidian notes.

wakatime

About

A plugin for Obsidian that sorts todos within a note

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 87.3%
  • JavaScript 12.7%