Obsidian Plugin: Meld Syncthing Conflicts

Resolve Syncthing sync conflicts in your Obsidian vault with Meld.

One command collects every *.sync-conflict-* file in the vault and opens each one next to its original as a tab in a single Meld window. When you close Meld, you choose which conflict files to delete.

Requirements

• Desktop only. The plugin starts an external program and reads and deletes files, so it does not work on mobile.
• Meld must be installed separately. Download it from meldmerge.org.
• If Meld is not on the PATH that Obsidian sees (common on Windows, macOS, Flatpak and Snap installs), set its full path in the plugin settings. See Settings.

Usage

1. Open the command palette and run Open sync conflicts in Meld.
2. Meld opens with one tab per conflict. Several conflicts for the same file are ordered by timestamp.
3. Merge what you want in each tab. Edits to the original file need to be saved.
4. Close Meld when you are done, or when you want to stop early.
5. A checklist lists every conflict file. Tick the ones to delete and click Delete selected, or click Keep all.

Which files are pre-checked?

The plugin cannot know which tabs you actually merged, so it guesses. A conflict file is pre-checked when it is now identical to the original, or when the original was edited while Meld was open. Everything else is unchecked and stays on disk unless you tick it. Dismissing the dialog keeps everything.

Stopping midway

Close Meld at any point. Nothing is deleted without the checklist. Conflicts you leave on disk are picked up the next time you run the command.

Settings

Setting	Description
Meld path	Leave as meld if Meld is on your PATH. Otherwise enter the full path to the executable.

Example paths:

• Windows: C:\Program Files\Meld\Meld.exe
• macOS: /Applications/Meld.app/Contents/MacOS/Meld
• Linux: /usr/bin/meld

Notes and limitations

• Originals that no longer exist (deleted on another device) are skipped.
• Folders .git, .trash and node_modules are not scanned. Conflicts inside .obsidian are included, though often meaningless.
• On Windows, a very large number of conflicts at once could exceed the command-line length limit.
• The plugin only deletes files matching Syncthing's conflict naming pattern, and only the ones you confirm in the checklist.

Manual installation

1. Create the folder <vault>/.obsidian/plugins/syncthing-meld/.
2. Clone the git repository into it.
3. Reload Obsidian and enable Meld merge Syncthing Conflicts under Settings → Community plugins.