Add status icons to your files automatically based on frontmatter status field. The plugin monitors your files in real-time and updates the icons as you change the status in your frontmatter.
See the icons on the obsidian file explorer. good for task management through file.
- Automatically adds status icons based on frontmatter
- Supports multiple status values
- Updates in real-time
- Better to do task management through file and GTD
Add a status field to your file's frontmatter:
---
status: todo
---Or multiple statuses:
---
status: [todo, important]
---| Status | Icon | Description |
|---|---|---|
| todo | 🔲 | Task to be done |
| incomplete | 🟡 | Work in progress |
| done | ✅ | Completed task |
| canceled | ❌ | Canceled or abandoned |
| forwarded | ➡️ | Forwarded or moved |
| scheduling | 📅 | Needs scheduling |
| question | ❓ | Needs clarification |
| important | Important item | |
| star | ⭐ | Starred item |
| quote | 💬 | Contains quotes |
| location | 📍 | Location-related |
| bookmark | 🔖 | Bookmarked information |
| information | ℹ️ | Information note |
| savings | 💰 | Finance-related |
| idea | 💡 | Ideas or concepts |
| pros | 👍 | Positive points |
| cons | 👎 | Negative points |
| fire | 🔥 | Hot/Urgent |
| key | 🔑 | Key information |
| win | 🏆 | Achievement |
| up | ⬆️ | Increasing/Growing |
| down | ⬇️ | Decreasing/Declining |
- Open Obsidian Settings
- Go to Community Plugins and disable Safe Mode
- Click Browse and search for "Frontmatter Task Mgmt"
- Install and enable the plugin
- Download
main.js,styles.css, andmanifest.jsonfrom the latest release - Copy these files to your vault's
.obsidian/plugins/frontmatter-status-icons/directory
- NodeJS v16 or higher
- npm or yarn
- Clone this repository
- Install dependencies:
npm install
- Start development build:
npm run dev
For production build:
npm run buildRun ESLint to check code quality:
npm run lintIf you encounter any issues or have suggestions:
- Check the GitHub Issues to see if it's already reported
- If not, create a new issue with:
- Obsidian version
- Plugin version
- Steps to reproduce
- Expected vs actual behavior
- Obsidian v0.15.0 or higher
This project is licensed under the MIT License - see the LICENSE file for details.

