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)
• 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 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/