Plugin Migrator

unlisted

by zheng

Manage and sync plugins across multiple vaults.

2 starsUpdated 1mo agoMIT
View on GitHub

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

  1. Open Plugin Manager via the puzzle icon in the left ribbon, or run "Plugin Manager: Open" from the command palette.
  2. Select a source vault — Choose the vault that has the plugins you want to copy.
  3. Select plugins — Check the plugins you want to copy. You can use "Select All" / "Deselect All" for convenience.
  4. Select target vaults — Choose one or more vaults to copy the selected plugins into. A version preview shows what will change for each vault.
  5. 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:

OptionDescription
OverwriteReplace all conflicting plugins with the source versions
SkipOnly copy plugins that don't exist in the target vault
CancelAbort the entire operation

Installation

From BRAT (Recommended before Obsidian review)

  1. Install BRAT from the Obsidian community plugin browser.
  2. Open BRAT settings → "Add Beta plugin with frozen version".
  3. Enter the repository URL.
  4. Enable "Plugin Manager" in Obsidian community plugins settings.

Manual Installation

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create a folder named plugin-manager inside your vault's .obsidian/plugins/ directory.
  3. Copy the downloaded files into that folder.
  4. 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.