Link Grouper

by eluisjonathan
5
4
3
2
1
Score: 35/100
New Plugin

Description

Groups links from the active note into a newly created sibling folder. - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

README file from

Github

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

License

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