Unread+

approved

by Lucy

Marks new files with a dot. Propagates unread counts up the folder tree. - This plugin has not been manually reviewed by Obsidian staff.

129 downloadsUpdated 1mo agoMIT

Unread+

Track unread files in Obsidian. New files get a colored dot — folder badges propagate counts up the entire tree so you always know where to look, even in a collapsed vault.

File explorer with dots and folder badge


Features

Colored dots — Unread (blue) and Later (orange) by default. Fully customizable — add any status with any color.

Folder badges — each parent folder shows a per-status count (1● 1●) at every depth, even collapsed.

Status bar — total unread count visible at the bottom of Obsidian at all times.

Dot aging — fresh dots start at full opacity and fade slightly each day. Files you've been sitting on for a week look the part.

Snooze — right-click → Snooze 1 day / 3 days / 1 week. The dot disappears and comes back automatically when the time is up.

Offline detection — files created by scripts or sync tools while Obsidian was closed are picked up automatically on the next launch.

Open Next UnreadCtrl+Shift+U opens all unread files one by one until the queue is empty.

Colored context menu — each status shows its own colored circle. No guessing.

Right-click context menu


Installation

  1. Download main.js, manifest.json, styles.css from the latest release
  2. Copy to .obsidian/plugins/unread-plus/ in your vault
  3. Settings → Community Plugins → enable Unread+
# From source
git clone https://github.com/kashicards/unread-plus.git
cd unread-plus && npm install && npm run build

Usage

ActionHow
Set statusRight-click file → pick status
Set selected files unreadSelect files → right-click → Mark selected as Unread
Clear selected filesSelect files → right-click → Mark selected as read
Clear statusRight-click → Mark as read
SnoozeRight-click → Snooze 1 day / 3 days / 1 week
Open next unreadCtrl+Shift+U
Mark all as readCommand palette → Mark all as read

Settings

Settings

  • Auto-read delay — auto-clear status after N seconds of the file being open
  • Show label in badge — display Unread ● instead of just
  • Ignored paths / extensions — never track certain folders or file types (json excluded by default)
  • Statuses — add, rename, recolor; "Counts as open" controls folder badges and queue inclusion
  • Queue — order and auto-mark behavior for Ctrl+Shift+U

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.