Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Join the community
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Usher

vrtmrzvrtmrz497 downloads

The overridden config directory manager

Add to Obsidian
  • Overview
  • Scorecard
  • Updates5

Manages multiple .obsidian directories efficiently.

How to use

  1. Install this plugin from BRAT
  2. Type Show Usher in the command palette
  3. The Usher pane will be displayed!

Features

Buttons and checkboxes

Name Behaviour
Update List Update the list
Hide empty Hide entries with no candidates
Only Selected Show only the selected entry (Used with Automatic Selection Buttons)
Only New Limit automatic selection only to newer entries than the current device's one
Apply Apply the selected entry to the current device

Automatic Selection Buttons

These buttons are automatically selected to apply to the current device. They are also displayed by category. They only affect the selected category.

Name Behaviour
❌ Clear the selection
📅 Select the most recently modified
🏷️ Select latest version (Theme and Plugins only)
⚙ Select different content (JSON only, after merged) [^1]
⚡ Select modified and latest file (Mostly for snippets)
🔒 Exclude from Automatic Selection

[^1]: JSON files will be merged with the current one.

How to read the difference report

  • When it is thin coloured, it means the file will not be valuable to be applied.
    • For example, the file is the same as the current one, or it is older in version or modification date than the current one.
  • When it is thick coloured (like tags), it means the file will be valuable to apply.
    • For example, the file is newer (version or modified) than the current one.
  • Automatic selection will follow your preference from the thick coloured files.
  • If you want to include the thin coloured file, you should uncheck the Only New checkbox.
  • On default, only the selected entry will be displayed. If you want to see all entries, you should uncheck the Only Selected checkbox.
  • Once you have made a selection and are ready to apply it, you should click the Apply button.

Configuration

Ignore files

We can configure the files to be ignored by the Usher in regular expression. The default value is /node_modules$ and /.git$.

Non-mergeable files

We can configure the files to be non-mergeable by the Usher in regular expression. The default value is /bookmarks.json$.

Utility

  • Duplicate Config folder
    • Duplicate the current config folder to the new folder.
    • Very useful when you want to create a new config folder based on the current one.
  • Delete Other devices' config folder
    • This action is tremendously dangerous, but sometimes useful. This action will delete the selected config folders.
    • We cannot select the current device's folder.
    • Deleted files will be moved to the trash.
75%
HealthGood
ReviewCaution
About
Manage multiple .obsidian directories and visually compare overridden configs in a dedicated Usher pane with diff highlights showing newer or unchanged files. Apply selected entries to the current device using automatic selection rules, filters and optional JSON merging.
FoldersAutomationJSON
Details
Current version
0.0.5
Last updated
Last year
Created
Last year
Updates
5 releases
Downloads
497
Compatible with
Obsidian 0.15.0+
License
MIT
Report bugRequest featureReport plugin
Author
vrtmrzvrtmrz
github.com/vrtmrz
GitHubvrtmrz
  1. Community
  2. Plugins
  3. Folders
  4. Usher

Related plugins

Waypoint

Easily generate dynamic MOCs in your folder notes using waypoints. Enables folders to show up in the graph view and removes the need for messy tags!

Auto Note Mover

Automatically move the active notes to their respective folders according to rules you set.

Auto Template Trigger

Automatically prompt for a template, when creating a note.

Default Template

Automatically apply templates to new notes with user-configurable template selection.

Templater

Create and use dynamic templates.

BRAT

Easily install a beta version of a plugin for testing.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

Readwise Official

Sync highlights from Readwise to your vault.

Advanced URI

Control everything with URI.

Auto Link Title

Automatically fetches the titles of links from the web.