Quilden-Sync is an Obsidian plugin that keeps your vault in sync with GitHub. It adds end-to-end encryption, file history, and Quilden web editor support.
Use it to:
- Back up your vault to GitHub
- Keep your notes in sync across devices
- Store files with end-to-end encryption
- Track file changes with history
- Open content in the Quilden web editor when needed
Before you start, make sure you have:
- A Windows PC
- Obsidian installed
- A GitHub account
- A vault you want to sync
- Enough space for your vault and file history
For best results, use:
- Windows 10 or Windows 11
- A stable internet connection
- The latest version of Obsidian
Visit this page to download the latest release:
On that page, look for the newest release and download the Windows file or plugin package attached to it.
Follow these steps in order.
- Open the download page in your browser.
- Find the latest release at the top of the page.
- Download the file for Windows.
- If the file is in a ZIP folder, save it to your Downloads folder.
- Right-click the ZIP file and choose Extract All.
- Open your Obsidian vault folder.
- Copy the Quilden-Sync plugin files into the Obsidian plugin folder.
- If Obsidian asks to trust the plugin, choose to trust and enable it.
- Restart Obsidian.
If the release includes a setup file, double-click it and follow the prompts. If it includes a plugin folder, place that folder in your vault’s .obsidian/plugins directory.
After you install it, open Obsidian and do this:
- Open Settings.
- Go to Community plugins.
- Turn on Quilden-Sync.
- Open the Quilden-Sync settings page.
- Connect your GitHub account or paste your access token.
- Choose the GitHub repository you want to use.
- Set your encryption password or key.
- Pick the folders you want to sync.
- Save your settings.
If you use the Quilden web editor, add the editor link in the settings page so the plugin can open files there when needed.
Quilden-Sync protects your vault with end-to-end encryption. That means your notes are encrypted before they leave your device.
It also keeps file history so you can:
- View earlier versions of a file
- Restore old content
- Check when a note changed
- Recover from mistakes
To get the best results:
- Use one strong encryption password
- Keep your GitHub access token private
- Sync only the folders you want to store online
Quilden-Sync watches your vault for changes. When you edit a file, it can:
- Encrypt the file
- Upload the change to GitHub
- Save version history
- Pull changes from GitHub to your vault
If you use more than one device, make sure each device uses the same GitHub repo and encryption settings.
Before your first sync, check these items:
- Obsidian is open
- Quilden-Sync is enabled
- Your GitHub account is connected
- Your repo name is correct
- Your encryption password matches on all devices
- Your sync folder is selected
- Your internet connection is active
Then run the first sync from the plugin settings. The first sync may take longer if your vault is large.
A simple setup works best:
- Keep your vault in one main folder
- Store attachments in a separate folder if you use many images
- Sync only the folders you need
- Avoid moving the vault while a sync is running
Example layout:
Vault/Notes/Images/Projects/
This makes it easier to keep track of what gets synced.
Open the Quilden-Sync panel and choose the sync option. Use this when you want to send recent changes to GitHub right away.
Use this when you made changes on another device. The plugin will bring those changes into your vault.
If you use the Quilden editor, open a file from the plugin menu and choose the web editor option.
Open a file history view to see earlier versions. You can compare changes and restore an older copy.
If Windows blocks the file:
- Right-click the downloaded file.
- Choose Properties.
- Look for an Unblock option.
- Check Unblock if you see it.
- Click OK.
If Obsidian does not show the plugin:
- Close Obsidian.
- Check the plugin folder in
.obsidian/plugins. - Make sure the Quilden-Sync folder is there.
- Reopen Obsidian.
- Enable the plugin in Community plugins.
After setup, test the plugin with one short note:
- Create a new note in Obsidian.
- Type a short line of text.
- Save the note.
- Run sync.
- Open your GitHub repo and check that the file appears.
Then change the note and sync again to see file history update.
You may need a GitHub token to let the plugin write to your repo.
Use a token with only the access needed for your vault. Keep it in the plugin settings, not in a note.
If you use more than one device, use the same repo and the same encryption settings on each one.
- Restart Obsidian
- Check the plugin folder name
- Make sure the files are in
.obsidian/plugins - Turn on Community plugins
- Check your internet connection
- Confirm your GitHub token is valid
- Check that the repo name is correct
- Make sure the plugin is enabled
- Confirm both devices use the same repo
- Confirm both devices use the same encryption key
- Run a pull on the second device
- Check for file conflicts
- Make sure you synced the file after each change
- Check that the file stayed in the synced folder
- Confirm the repo has the latest commits
- Check the editor link in settings
- Make sure the web editor address is correct
- Try opening it in your browser first
Keep a second backup in place. GitHub helps with history and sync, but a local backup is still useful.
Good habits:
- Back up your vault before first use
- Test one small folder first
- Keep your encryption password in a safe place
- Review your repo after major changes
Quilden-Sync fits users who want:
- A simple way to back up notes
- GitHub-based sync for an Obsidian vault
- Encryption for private content
- File history for note recovery
- Quilden web editor support
Download the latest version here:
Use the latest release file for Windows, then install it in Obsidian and enable the plugin