Obsidian Link Grouper

Link Grouper is an Obsidian plugin designed to automatically organize and group all files linked or embedded in your active note into a newly created, dedicated sibling folder.

This is perfect for workflows that prioritize clean structures, dashboard-style index notes, or project-based groupings without manual file sorting.

Features

• Automatic Grouping: Detects all internal links ([[Note]]) and embedded media/attachments (images, PDFs, audio, etc.) in your active note.
• Dedicated Sibling Folders: Creates a folder at the same level as the active note, named exactly after the note.
• Collision Prevention: If a folder with the note's name already exists, the plugin automatically appends an incremental number (e.g., Note Name 1, Note Name 2) to ensure no directories or contents are overwritten.
• Link Integrity: Uses Obsidian's native API to relocate the files, ensuring all links across your entire vault are automatically updated and nothing is broken.

How to Use

1. Open any note containing links to other notes or attachments.
2. Open the Obsidian Command Palette (Ctrl + P or Cmd + P).
3. Search for and run: Link Grouper: Group links of this note in a sibling folder.
4. The plugin will create the folder, move the linked files inside it, and safely update the links.

Tip: You can assign a custom hotkey to this command (e.g., Ctrl + Alt + G) in Settings -> Hotkeys.

Installation

Manual Installation

If you want to install and test the plugin manually:

1. Create a folder named obsidian-link-grouper inside your vault's plugin directory:

   mkdir -p /path/to/your/vault/.obsidian/plugins/obsidian-link-grouper
   

2. Copy the compiled main.js and manifest.json from the release assets (or from your build directory) into that folder.
3. Open Obsidian, go to Settings -> Community Plugins, and enable Link Grouper.

Development

If you want to compile and build the plugin from source:

1. Clone this repository.
2. Install the development dependencies:

   npm install
   

3. Compile the production bundle:

   npm run build
   

Author

Developed by Luis Ordoñez

• GitHub: @eluisjonathann

License

This project is licensed under the MIT License - see the LICENSE file for details.