README file from
GithubBetter Plugins Manager
🎯 What is BPM?
Better Plugins Manager is a powerful Obsidian plugin manager that provides a richer management experience than the native one.
Delay Start • Batch Operations • Groups & Tags • GitHub Install • Conflict Troubleshooter • Mobile Friendly
✨ Core Features
🚀 Performance Optimization
| Feature | Description |
|---|---|
| Delay Start | Start plugins with preset delays to reduce startup lag |
| Startup Self-Check | 🆕 Detect plugin management conflicts, prevent Obsidian and BPM from controlling plugins simultaneously |
This feature needs to be enabled in settings, disabled by default.
📦 Batch Management
| Feature | Description |
|---|---|
| Toggle All | Quickly enable/disable all plugins |
| Group Operations | Batch enable/disable by group |
| Quick Search | Filter by status, group, tag, delay, and keywords |
🏷️ Organization & Annotation
| Feature | Description |
|---|---|
| Custom Names | Give plugins memorable names |
| Notes & Descriptions | Record plugin usage and configuration notes |
| Groups & Tags | Flexible categorization, BPM installs auto-tagged bpm-install |
📥 GitHub Installation
| Feature | Description |
|---|---|
| Repo Install | Supports user/repo or full URL |
| Version Selection | Pick releases like BRAT |
| Jump to Repo | One-click jump to GitHub from plugin card |
🔍 Conflict Troubleshooter 🆕
| Feature | Description |
|---|---|
| Binary Search | Quickly locate problematic plugins or conflict pairs |
| Wizard-style UI | Draggable floating window, test while troubleshooting |
| Generate Report | Export Markdown troubleshooting report |
↕ Customize Ribbon Bar 🆕
If you are annoyed by the ribbon icons changing order every time you start Obsidian due to BPM's delayed startup, please use this feature.
| Feature | Description |
|---|---|
| Show/Hide Ribbon Icons | Customize the visibility of each icon on the ribbon bar |
| Customize Ribbon Order | Customize the order of each icon on the ribbon bar by dragging |
📱 Mobile Adaptation
| Feature | Description |
|---|---|
| Responsive Layout | Auto-switch between mobile/desktop layouts |
| Collapsible Action Bar | Save screen space |
| Long-press Tooltips | Touch-friendly interaction |
📦 Installation
Method 1: Official Marketplace (Recommended)
- Open Obsidian Settings → Community Plugins
- Search for "Better Plugins Manager"
- Click Install and Enable
Method 2: Manual Installation
- Download the latest Release
- Extract to
.obsidian/plugins/better-plugins-manager/ - Restart Obsidian and enable
🚦 Quick Start
Open the Manager
- Click the 📁 icon in the sidebar
- Or use Command Palette:
Ctrl/Cmd + P→ "Open Plugin Manager"
The panel is divided into three areas, from top to bottom:
- Action Button Area
- Filter & Search Area
- Plugin List Area
Usage Tips
- Left-click to interact with elements, hover over buttons to see tooltips
- Right-click to open context menu
🔍 Plugin Conflict Troubleshooter
When encountering issues caused by plugin conflicts, use the Conflict Troubleshooter wizard:
How to Use
- Click the 🔍 button on the toolbar or use command "Troubleshoot plugin conflicts"
- Follow the wizard prompts
- Test if the problem exists at each step, click the corresponding button
- Automatically locate the problematic plugin or conflict pair
Supported Scenarios
- Single Plugin Issue: A plugin itself has a bug
- Two-Plugin Conflict: Two plugins work fine separately but conflict when used together
Tips
- The floating window is draggable for convenient testing
- Supports undo last step
- Troubleshooting state is saved, can continue after restart
⚙️ Startup Self-Check
BPM checks community-plugins.json on startup:
| Situation | Action |
|---|---|
| Only BPM | Normal startup |
| Other plugins present | Prompt to take over |
Why Takeover?
- Avoid Obsidian and BPM controlling plugins simultaneously
- Ensure delay-start and other features work properly
- Maintain plugin state consistency
📤 Export to Obsidian Base
Configuration
Set Plugin info export directory in settings (folder inside your vault)
Rules
| Prefix | Permission |
|---|---|
bpm_rw_* |
Read-write |
bpm_ro_* |
Read-only |
bpm_rwc_repo |
Conditionally writable |
Frontmatter Example
---
bpm_ro_id: some-plugin
bpm_rw_name: Custom Name
bpm_rw_desc: Custom Description
bpm_rw_note: Note
bpm_rw_enabled: true
bpm_rwc_repo: user/repo
bpm_ro_group: group-id
bpm_ro_tags:
- tag-a
- bpm-install
bpm_ro_delay: delay-id
bpm_ro_installed_via_bpm: true
---
Body section: You can edit or replace this content.
⚙️ Settings
| Setting | Description |
|---|---|
| Delay Profiles | Create delay configurations and assign to plugins |
| Hide BPM Tag | Keep auto-tag but hide from UI |
| GitHub API Token | Increase rate limits for release fetching |
| Fade Disabled Plugins | Visually dim disabled plugin cards |
| Export Notice Text | Customize the body text of exported files |
| Self-Check Reminder | Control whether startup self-check popup shows |
⌨️ Commands
| Command | Description |
|---|---|
| Open Plugin Manager | Open BPM main interface |
| Troubleshoot plugin conflicts | 🆕 Start conflict troubleshooter wizard |
| Enable/Disable [Plugin Name] | Per-plugin toggle (enable in settings) |
| Enable/Disable [Group Name] | Group batch operations (enable in settings) |
📱 Compatibility
| Platform | Supported |
|---|---|
| Windows / macOS / Linux | ✅ |
| Android | ✅ |
| iOS / iPadOS | ✅ |
The plugin automatically switches between desktop/mobile layouts based on the platform.
🤝 Contributing
Issues and PRs are welcome!
- Bug Reports: Please include logs and reproduction steps
- Feature Requests: Consider opening a discussion or issue first
🙏 Acknowledgments
- The ribbon sorting feature is inspired by Obsidian-ribbon-sort