obsidian-plugin/chrishoward-projects_related-notes-by-tag
1
0
Fork 0
mirror of https://github.com/chrishoward-projects/related-notes-by-tag.git synced 2026-07-22 13:00:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
105 commits 3 branches 22 tags 1.8 MiB
TypeScript 79.3%
CSS 10.8%
JavaScript 6.6%
Shell 3.3%
Find a file
chrishoward-projects 3d2a41e7ce Fix startup race condition causing updateView error. 
Added runtime type guard in getView() to verify the view is fully
initialized before calling methods. This prevents the "updateView is
not a function" error that occurred when the active-leaf-change event
fired during plugin initialization.

Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-14 20:45:36 +11:00
.claude Phase 1: Add folder exclusion data structures and settings interface 2025-08-04 22:38:32 +10:00
assets/images update readme image 2025-08-15 21:04:00 +10:00
plans expand collapse toggle plan 2025-08-15 22:30:01 +10:00
src Fix startup race condition causing updateView error. 2025-11-14 20:45:36 +11:00
.eslintignore Fix ESLint configuration and unused imports 2025-06-16 23:28:18 +10:00
.gitignore Improve gitignore with comprehensive ignore patterns 2025-08-16 02:20:34 +10:00
CHANGELOG.md Fix startup race condition causing updateView error. 2025-11-14 20:45:36 +11:00
CLAUDE.md update claude and development mds 2025-06-19 01:25:54 +10:00
deploy.sh add donate link 2025-06-16 22:21:48 +10:00
DEVELOPMENT.md update claude and development mds 2025-06-19 01:25:54 +10:00
esbuild.config.mjs refactor and tweaks 2025-05-25 16:48:56 +10:00
eslint.config.mjs Fix ESLint configuration and unused imports 2025-06-16 23:28:18 +10:00
LICENSE Add LICENSE and fix release process 2025-06-17 17:10:08 +10:00
manifest.json Fix startup race condition causing updateView error. 2025-11-14 20:45:36 +11:00
package.json Fix startup race condition causing updateView error. 2025-11-14 20:45:36 +11:00
prepare-changelog.mjs Add comprehensive changelog system 2025-06-16 01:33:55 +10:00
README.md update readme and usage. v0.4.2 2025-08-20 00:43:46 +10:00
RELEASE.md Add LICENSE and fix release process 2025-06-17 17:10:08 +10:00
release.sh Add LICENSE and fix release process 2025-06-17 17:10:08 +10:00
styles.css Implement simple expand/collapse all button 2025-08-15 22:53:09 +10:00
tsconfig.json initial commit. phase 1 completed 2025-05-18 23:32:55 +10:00
version-bump.mjs Fix version synchronization issue 2025-06-17 16:00:06 +10:00
versions.json Fix startup race condition causing updateView error. 2025-11-14 20:45:36 +11:00

README.md

Related Notes by Tag

Discover related content in your Obsidian vault through tag-based connections. This plugin displays notes that share tags with your currently active note, helping you find related notes and build stronger knowledge connections.

If you're a heavy tag user, this plugin makes tags even more useful.

1.00

Features

  • Automatic Discovery: Instantly shows related notes when you open any tagged note
  • Sidebar Integration: Clean, unobtrusive sidebar panel that fits seamlessly into your Obsidian workflow
  • Real-time Updates: Automatically refreshes when you switch between notes
  • Tag-based Matching: Finds notes that share one or more tags with your current note
  • Flexible Sorting: Sort related notes by name, modified date, or creation date
  • Tag Filtering: Set minimum tag match requirements (1, 2, or 3+ matching tags)
  • Matched Tags Display: Toggle to show which specific tags are shared between notes
  • Collapsible Groups: Organize results by tag with expandable/collapsible sections
  • Folder Exclusion: Exclude files from specific folders with granular control over subfolders

Installation

From Obsidian Community Plugins

  1. Open Obsidian Settings
  2. Go to Community Plugins
  3. Search for "Related Notes by Tag"
  4. Click Install, then Enable

Manual Installation

  1. Download the latest release from GitHub
  2. Extract to your vault's .obsidian/plugins/related-notes-by-tag/ folder
  3. Enable the plugin in Obsidian Settings > Community Plugins

How to Use

  1. Find the Panel: After installation, the Related Notes by Tag panel automatically appears in your right sidebar (but stays closed)
  2. Open the Panel: Click on the "Related Notes by Tag" tab in the right sidebar, or use the command palette ("Open Related Notes by Tag sidebar")
  3. Browse Related Notes: The panel will automatically show notes related to your active note
  4. Customize Display: Use the controls to sort, filter, and toggle tag visibility
  5. Navigate: Click note titles to open them, or use modifier keys for new tabs
  6. Quick Navigation: Click any note title to open it immediately
  7. Modifier Support: Cmd/Ctrl+click to open notes in new tabs
  8. Preview Support: Hover with Cmd/Ctrl held to preview note content

USAGE TIP

If you're finding a tag for a note has too many notes below it, try switching the filter to 2 matches or 3 matches. Also, try adding more tags to your current note

Settings

Access plugin settings through Obsidian Settings > Plugin Options > Related Notes by Tag:

General Settings

  • Default Sort Mode: Choose how related notes are sorted by default
  • Excluded Tags: Specify tags to ignore when finding related notes (# prefix optional)
  • Default Group State: Set whether tag groups start collapsed or expanded

Folder Exclusion

  • Exclude Specific Folders: Add multiple folder paths to exclude from related notes
  • Autocomplete Support: Type folder paths with intelligent autocomplete suggestions
  • Include Subfolders Toggle: Choose whether to exclude just the folder or include all subfolders
  • Dynamic Descriptions: Real-time preview of what will be excluded as you configure settings
  • Easy Management: Add folders with one click, delete with intuitive trash icon

Requirements

  • Minimum verified on Obsidian v1.9.x
  • Notes with tags (hashtags or YAML frontmatter)

Support

Found a bug or have a feature request? Please open an issue on GitHub.

Author: Chris Howard (GitHub)

Buy me a coffee