# 🗂️ Obsidian Settings Sidebar Organizer

**Tame your plugin list.** Group community plugins, rename them (alias), reorder them manually or automatically, compact the sidebar UI headers, and more...

![Screenshot](gifs/1.gif)

## 🗿 Why?

Created because I had too many plugins and got lost in the sidebar; feedback welcome!

<a href="https://www.buymeacoffee.com/golomp" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>

> [!CAUTION]
> **Experimental "DOM Hack":**
> This plugin manipulates the Obsidian UI directly because there is no official API for the settings sidebar.
> * **Risk:** If Obsidian updates their UI structure (CSS classes), this plugin might break or stop working until updated.
> * **Stability:** It creates "proxy" buttons. When you click an item in a group, it programmatically clicks the real, hidden button.

## ✨ Key Features

### 1. 📂 Grouping & Organization
* **Custom Folders:** Create your own categories (e.g., "Design", "Automation").
* **Multi-folder Support:** Plugins can belong to multiple groups at once.
* **Keyword Matching:** Sorts plugins into groups based on keywords separated by commas (including spaces). Hover over a live-updating badge to see your matches on the fly (info about multi-folder presence, if plugin is disabled, if it has no ui, and more).
* **"Ungrouped" Folder:** Automatically catches any plugin that doesn't match your keywords so nothing gets lost (can be hidden).

### 2. ✏️ Aliases & Order
* **Renaming (Aliasing):** Rename plugins to save space or improve clarity. You can even give the same plugin multiple aliases in different groups if you want.
* **Sorting Options:** Sort your plugins inside each group alphabetically, or use drag & drop to manually order them exactly how you want them (you can also manually order the groups themselves).

### 3. 📝 Plugin Management & Notes
* **Plugin Toggles:** Enable or disable your plugins directly from the group configuration menu.
* **Custom Notes:** Add personal notes to any plugin (e.g., why you disabled it or what it does). Hover over the note icon or the plugin in the sidebar to read it.
* **Single-File Interoperability:** Keep your notes in sync with a standalone `.md` file for easy bulk editing. Supports custom paths, even inside hidden system folders like `.obsidian/plugins/Notes.md`.

### 4. 📉 Compact & Clean UI
* **Compact Mode:** Hides the large "Core plugins" and "Community plugins" tabs. It moves them to small ⚙️ icons in the section headers to improve clarity.
* **Collapsible Headers:** Allows you to fold the main "Options", "Core plugins", and "Community plugins" sections.
* **Collapse by Default:** Option to automatically collapse all groups each time you reopen the settings menu (instead of saving exactly how you left them).

## 📦 Installation

### Method 1: Obsidian site (the fastest)
1. Go to https://community.obsidian.md/plugins/settings-sidebar-organizer.
2. Click `Add to Obsidian`.
3. Click **Install**, then **Enable**.

### Method 2: Inside Obsidian
1. Open Obsidian and go to **Settings > Community plugins > Browse**.
2. Search for `Settings Sidebar Organizer`.
3. Click **Install**, then **Enable**.

### Method 3: Manual
1. Download `main.js`, `styles.css`, and `manifest.json`.
2. Create folder `.obsidian/plugins/settings-sidebar-organizer/`.
3. Paste files and reload Obsidian.

### Method 4: BRAT
1. Install **BRAT** from the Community Plugins store.
2. Go to **Settings > BRAT > Add Beta plugin**.
3. Paste this repo URL: `https://github.com/CyrylSz/obsidian-settings-sidebar-organizer`.
4. Click **Add Plugin**.

## ⚙️ How to use
Everything is configured via **Settings > Settings Sidebar Organizer**:

1.  **Create Group:** Click `+ Add Group`.
2.  **Assign Plugins:** Type keywords (comma-separated) in the "Keywords" box.
3.  **Fine-tune:** Click the **Gear Icon (⚙️)** next to a group to:
    * Set an **Alias** (rename).
    * **Reorder** items manually via drag & drop or **Sort** them alphabetically.
    * **Toggle** plugins on/off.
    * Write **Notes** for your plugins.