Obsidian Note Status Plugin

The Note Status plugin for Obsidian enhances your workflow by allowing you to assign, manage, and visualize statuses for your notes. Whether you're tracking projects, tasks, or personal notes, this plugin provides a seamless way to organize your vault with customizable statuses, a dedicated status pane, and visual indicators.

Features

• Status Assignment: Add statuses (e.g., active, on hold, completed, dropped, unknown) to notes via frontmatter.
• Status Pane: A sidebar view to see all notes grouped by status, with search and collapsible sections.
• Dropdown Menu: Quickly change a note’s status from a dropdown at the top or bottom of the editor.
• Status Bar: Displays the current note’s status at the bottom of the app, with toggleable visibility.
• File Explorer Icons: Shows status icons next to note names in the file explorer for instant recognition.
• Customization: Define your own statuses, icons, and colors in the settings, and adjust UI preferences like position and auto-hiding.
• Commands: Includes commands to refresh statuses, insert status metadata, and open the status pane.

Installation

1. Download the Plugin:
   • Grab the latest release (v1.0.2) from the GitHub Releases page.
   • Extract the zip file to get the plugin folder (obsidian-note-status).
2. Install in Obsidian:
   • Open your Obsidian vault and navigate to .obsidian/plugins/.
   • Copy the obsidian-note-status folder into this directory.
   • If the plugins folder doesn’t exist, create it.
3. Enable the Plugin:
   • In Obsidian, go to Settings > Community Plugins.
   • Ensure "Safe Mode" is turned off.
   • Find "Note Status" in the list and toggle it on.

Note: This plugin is not yet available in the Obsidian Community Plugin store but will be submitted soon!

Usage

Setting a Status

• Open a note and use the command Insert Status Metadata to add a status: unknown field in the frontmatter.
• Change the status manually in the frontmatter, or use the dropdown menu (click the status bar or right-click in the editor and select "Change Note Status").

Status Pane

• Click the ribbon icon (a bar chart) or use the Open Status Pane command to view all notes grouped by status.
• Use the search bar to filter notes by name.

Customization

• Go to Settings > Note Status to:
  • Toggle visibility of the dropdown, status bar, and file explorer icons.
  • Adjust positions (top/bottom for dropdown, left/right for status bar).
  • Add, edit, or remove custom statuses with unique icons and colors.

Example Frontmatter

---
status: active
---

Screenshots

• Status Pane:

• Dropdown Menu:

• File Explorer Icons:

Development

Prerequisites

• Node.js and npm installed.
• Obsidian API knowledge (TypeScript-based).

Building the Plugin

1. Clone this repository:

git clone https://github.com/devonthesofa/obsidian-note-status.git
cd obsidian-note-status

2. Install dependencies:

npm install

3. Build the plugin:

npm run build

4. The compiled plugin will be in the root directory, ready to copy into .obsidian/plugins/.

Contributing

• Fork this repository and submit pull requests with improvements or bug fixes.
• Report issues or suggest features via the Issues tab.

Known Limitations

• Dropdown positioning uses DOM-based workarounds due to limited API support for editor coordinates.
• Initial release; some edge cases may still need refinement—please report bugs!

License

This plugin is released under the . Feel free to use, modify, and distribute it as you see fit.

Acknowledgments

• Built with help from xAI’s Grok for code assistance and debugging.
• Inspired by the amazing Obsidian community and its plugin ecosystem.