README file from
GithubProgressive
Progressive is an Obsidian plugin that displays a progress bar in the file explorer sidebar, showing the percentage of tasks that have been completed across your notes.
It supports daily, weekly, monthly, or custom notes and can track either the latest, today’s, or all notes in a folder.
The progress bar color dynamically changes based on completion percentage for quick visual feedback.
Difference from progress-tracker
While both Progressive and progress-tracker help visualize task completion, Progressive is a different approach:
| Feature | Progressive | progress-tracker |
|---|---|---|
| Display Location | Sidebar (always visible in file explorer) | Inside individual notes |
| Purpose | Passive overview of total progress | Per-note task tracking |
| Setup | Automatic, no embedding or commands required | Manual embedding (inline in notes) |
| Customization | Theme-aware, multicolor, black/white modes | Fixed color and layout |
| Focus | Minimalism, zero interaction needed | Detailed tracking inside notes |
In short, Progressive gives you a global visual cue of how complete your workspace is without needing to open a single note.
Features
- Shows a progress bar in the sidebar, always visible.
- Supports daily, weekly, monthly, and custom note types.
- Tracking modes: latest note, today’s note, all notes in a folder or a custom note.
- Progress bar color changes through 12 levels depending on completion, but also features Black and White and themed based visuals.
- Works with both single notes and entire folders.
- Automatically updates when notes are modified.
How to use
- Go to Settings → Progressive.
- Choose a note or folder to track.
- Select the note type (Daily, Weekly, Monthly, or Custom).
- Choose a tracking mode:
- Latest → only the most recently modified note
- Today → today’s note (or this week/month if selected)
- All → all notes inside the selected folder
- The progress bar will appear automatically in your sidebar.
📦 Manual installation
To install manually, copy the following files into your vault:
VaultFolder/.obsidian/plugins/progressive/
Files required:
main.js
styles.css
manifest.json
Then reload Obsidian and enable Progressive from the Community Plugins tab.
Funding & Feedback
If you like Progressive, you can support its development by:
- Giving feedback on GitHub
- Reporting bugs or feature requests
- Sharing it with others in the Obsidian community
- Funding : If you really want to donate, give money to a charity
Documentation
For the latest Progressive documentation and updates, visit:
https://github.com/kelen-argosi/progressive