Obsidian Stats logoObsidian Stats

Unread Dot

by denmojo
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Marks unopened notes with a blue dot in the file explorer. Auto-clears the moment the note is opened.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Unread Dot

A small Obsidian plugin that marks newly created files with a blue dot in the file explorer and clears the dot the moment you open the file. Helps you spot notes you have not yet read without having to maintain any frontmatter or tags.

Features

  • New files (any extension) get a blue dot in the file explorer the moment they are created.
  • The dot disappears the first time you click the file in the explorer or open it in a tab.
  • State persists across restarts in .obsidian/plugins/unread-dot/data.json.
  • Renaming or moving a file preserves its unread state.
  • File-explorer only. Wikilinks, graph view, and the editor are untouched.
  • Optional ignore lists by extension or path prefix (e.g., skip attachments).
  • Right-click any file for "Mark as read" / "Mark as unread".
  • Commands: "Mark all notes as read", "Mark current note as unread".

First-run behavior

Existing files in the vault when you install the plugin are treated as already read. Only files created from that point forward get tracked. This avoids flooding the explorer with dots on day one.

Installation

From Community Plugins (once approved)

  1. Settings → Community plugins → Browse
  2. Search for "Unread Dot"
  3. Install and enable

Manual install

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create a folder .obsidian/plugins/unread-dot/ inside your vault.
  3. Drop the three files into that folder.
  4. Restart Obsidian and enable the plugin in Settings → Community plugins.

Via BRAT (pre-release testing)

  1. Install the BRAT plugin.
  2. Add the beta plugin: denmojo/obsidian-unread-dot.
  3. Enable it in Settings → Community plugins.

Settings

  • Ignored extensions - comma-separated list of extensions (no leading dot) to skip. Example: png, jpg, pdf, opus.
  • Ignored path prefixes - one path per line. Files whose path starts with any of these will not be marked. Example: Attachments/ or Archive/.
  • Mark all read button - clears every unread mark in the vault.

Changes to ignore rules apply immediately and prune any currently marked files that match.

Commands

Command Description
Unread Dot: Mark all notes as read Clears every unread mark.
Unread Dot: Mark current note as unread Adds the active note back to the unread set.

Right-click menu

Right-click any file in the explorer to toggle its unread state. Files matching an ignore rule do not show the menu item.

Known limitations

  • Tracked state lives in the vault's .obsidian/ folder, so it syncs across devices only if you sync .obsidian/ (e.g., Obsidian Sync, Syncthing).
  • The plugin uses Obsidian's internal view.fileItems to attach the marker. This is widely used by community plugins but is not part of the public API and may need adjustment if Obsidian changes the file-explorer internals.

License

MIT - see LICENSE.

Sponsors