Plugin Migrator
unlistedby zheng
Manage and sync plugins across multiple vaults.
Plugin Manager
An Obsidian plugin that helps you manage and sync third-party plugins across multiple Obsidian vaults on the same machine.
Why This Plugin?
If you work with multiple Obsidian vaults, you've probably experienced the pain of:
- Manually installing the same plugins over and over in each vault
- Keeping plugins at the same version across vaults
- Forgetting which vault has which plugin installed
Plugin Manager solves this by letting you browse, select, and copy plugins between vaults in just a few clicks.
Features
- Automatic vault discovery — Reads your Obsidian configuration to find all registered vaults automatically. No manual path configuration needed.
- Cross-vault plugin copying — Select plugins from one vault and copy them to one or more target vaults in a single operation.
- Version conflict detection — Detects when a target vault already has a different version of a plugin and shows a clear comparison before you decide.
- Batch operations — Copy multiple plugins to multiple vaults at once.
- Version preview — See exactly what will change (new install, upgrade, downgrade, or same version) before confirming.
- Self-aware — Recognizes itself in the plugin list so you can easily copy it to other vaults too.
Requirements
- Obsidian 0.15.0+
- Desktop only — This plugin uses Node.js filesystem APIs and does not work on mobile.
How to Use
- Open Plugin Manager via the puzzle icon in the left ribbon, or run "Plugin Manager: Open" from the command palette.
- Select a source vault — Choose the vault that has the plugins you want to copy.
- Select plugins — Check the plugins you want to copy. You can use "Select All" / "Deselect All" for convenience.
- Select target vaults — Choose one or more vaults to copy the selected plugins into. A version preview shows what will change for each vault.
- Confirm — Click "Copy Selected Plugins". If any version conflicts are detected, you'll be asked to choose how to resolve them.
After copying, remember to enable the newly copied plugins in each target vault's settings.
Conflict Resolution
When a plugin already exists in a target vault with a different version, you have three options:
| Option | Description |
|---|---|
| Overwrite | Replace all conflicting plugins with the source versions |
| Skip | Only copy plugins that don't exist in the target vault |
| Cancel | Abort the entire operation |
Installation
From BRAT (Recommended before Obsidian review)
- Install BRAT from the Obsidian community plugin browser.
- Open BRAT settings → "Add Beta plugin with frozen version".
- Enter the repository URL.
- Enable "Plugin Manager" in Obsidian community plugins settings.
Manual Installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create a folder named
plugin-managerinside your vault's.obsidian/plugins/directory. - Copy the downloaded files into that folder.
- Enable "Plugin Manager" in Obsidian → Settings → Community plugins.
Limitations
- Only works with vaults on the same machine. Network/cloud paths are not supported.
- Copies plugin files only. Plugin settings and configurations are not synced.
- Copied plugins must be manually enabled in each target vault.
- Does not check plugin dependencies or Obsidian version compatibility.
Development
# Install dependencies
npm install
# Development build with watch mode
npm run dev
# Production build
npm run build
License
MIT
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.