README file from
GithubObsidian 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
- Open any note containing links to other notes or attachments.
- Open the Obsidian Command Palette (
Ctrl + PorCmd + P). - Search for and run:
Link Grouper: Group links of this note in a sibling folder. - 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:
- Create a folder named
obsidian-link-grouperinside your vault's plugin directory:mkdir -p /path/to/your/vault/.obsidian/plugins/obsidian-link-grouper - Copy the compiled
main.jsandmanifest.jsonfrom the release assets (or from your build directory) into that folder. - Open Obsidian, go to Settings -> Community Plugins, and enable Link Grouper.
Development
If you want to compile and build the plugin from source:
- Clone this repository.
- Install the development dependencies:
npm install - 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.