📚 Quick Start Guide - devonthesofa/obsidian-note-status GitHub Wiki
Quick Start Guide
Get the Note Status plugin working in under 5 minutes.
Installation
Method 1: Community Plugin Store (Recommended)
- Open Obsidian → Settings → Community plugins
- Disable Safe mode
- Click "Browse" → Search "Note Status"
- Install and Enable
Method 2: Manual Installation
- Download latest release from GitHub
- Extract the following files into your Obsidian vault under
.obsidian/plugins/note-status/
:main.js
manifest.json
styles.css
- In Obsidian, go to Settings → Community plugins and enable Note Status.
First Status Assignment
Using the Toolbar
- Open any note
- Click the
❓
icon in the toolbar: - Select a status (e.g., "active")
- Status appears in status bar and file explorer:
Using Commands
- Press
Ctrl/Cmd + P
for command palette - Type "Change status"
- Select status from dropdown
Essential Settings
Access via Settings → Note Status:
✅ Show status bar
✅ Show status icons in file explorer
✅ Enable multiple statuses
❌ Auto-hide status bar (disable for learning)
Status Templates
Enable a template for instant statuses: Recommended for beginners: "Minimal workflow"
todo
📌inProgress
⚙️review
👀done
✓
First Workflow
- Create a project note → Set status to
todo
- Start working → Change to
inProgress
- Need feedback → Change to
review
- Complete → Change to
done
Viewing Your Statuses
Status Pane (Recommended)
- Click status icon in left sidebar
- See all notes grouped by status
- Click any note to open
File Explorer
- Status icons appear next to file names
- Right-click files to change status
- Select multiple files for batch updates -
Performance Setup (Large Vaults)
If you have 1000+ notes, set the settings:
✅ Exclude unassigned notes from status pane
✅ Hide unknown status in file explorer
Frontmatter Format
The plugin stores statuses in YAML frontmatter:
---
obsidian-note-status:
- active
---
Multiple statuses:
---
obsidian-note-status:
- idea
- HelloWorld
---
Next Steps
- User Manual - Complete feature guide
- Configuration Guide - Custom statuses and templates
- Performance Tuning - Optimize for your vault size
Quick Reference
Action | Method |
---|---|
Set status | Click toolbar icon |
Batch update | Select files → right-click |
View all statuses | Open status pane |
Add custom status | Settings → Custom statuses |
Remove status | Click status chip → X |