Random Note Plus

by wogong
5
4
3
2
1
Score: 50/100

Description

Reviews

No reviews yet.

Stats

1
stars
248
downloads
0
forks
177
days
64
days
177
days
3
total PRs
0
open PRs
3
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
14
commits

Latest Version

6 months ago

Changelog

Release 1.0.3

README file from

Github

Random Note Plus

Random Note Plus is an Obsidian community plugin that opens a random note while allowing you to exclude specific folders.

Features

  • Ribbon icon: Open Random Note
  • Command: Open Random Note
  • Settings tab with folder exclusions (one folder per line)
  • If no eligible notes remain after filtering, a notice is shown

Excluded folder behavior

  • Enter folder paths relative to your vault root
  • Templates excludes notes under Templates/...
  • Leading and trailing slashes are normalized (for example /Archive/ becomes Archive)
  • The same normalization applies when settings are loaded; invalid lists become empty and non-string entries are ignored
  • Matching is prefix-based on folder path

Privacy

Random Note Plus runs entirely inside Obsidian and does not make network requests.

When you use Open random note, the plugin asks Obsidian for the list of Markdown files in the vault so it can remove excluded folders and choose one eligible note. It uses file paths for that selection only, does not read note contents, and does not store or transmit the file list.

Install (manual)

  1. Build the plugin:
    npm install
    npm run build
    
  2. Copy main.js, manifest.json, and styles.css to:
    <Vault>/.obsidian/plugins/random-note-plus/
    
  3. In Obsidian, go to Settings → Community plugins, then enable Random Note Plus.

Development

npm install
npm run dev
  • npm run dev: watch mode build via esbuild
  • npm run build: type-check and production bundle
  • npm test: check exclusion rules and the settings-to-open workflow
  • npm run lint: run ESLint

Release

  1. Update manifest.json version.
  2. Update versions.json with "<version>": "<minAppVersion>".
  3. Create a GitHub release tag matching the version exactly (no leading v).
  4. Attach manifest.json, main.js, and styles.css as release assets.

Compatibility

  • Plugin ID: random-note-plus
  • Minimum Obsidian version: 0.16.0
  • Desktop only: false

Notes for local development

For local testing, make sure your plugin folder name in the vault matches the plugin ID in manifest.json:

.obsidian/plugins/random-note-plus/