OZSync syncs an Obsidian vault with ZimaOS storage for desktop backup, file browsing, and cross-device access.
- Manual vault sync to a configured ZimaOS directory
- Optional interval-based automatic sync
- ZimaOS cloud file browser inside Obsidian
- Upload, download, preview, folder creation, and delete actions in the browser
- Newer-file-wins sync based on modification time
- Local backup before a remote download overwrites an existing local file
- Status bar and status view for sync state
- Obsidian desktop
- A reachable ZimaOS server
- A ZimaOS account with access to the target storage path
This plugin is desktop-only.
After OZSync is accepted into the Obsidian community plugin directory:
- Open Obsidian Settings.
- Go to Community plugins.
- Search for OZSync.
- Install and enable the plugin.
Download the latest release assets from:
https://github.com/atopos31/OZSync/releases
Create this folder in your vault:
<Vault>/.obsidian/plugins/ozsync/
Copy these files into that folder:
main.js
manifest.json
styles.css
Restart Obsidian or reload the app, then enable OZSync from Community plugins.
Open OZSync settings and configure:
- Server URL: the ZimaOS host or IP address
- Port: the ZimaOS HTTP or HTTPS port
- Username and password: your ZimaOS credentials
- Sync directory: the remote ZimaOS path used for vault sync
- Auto sync: optional interval sync
The default sync directory is:
/media/ZimaOS-HD/Obsidian
Change it if your ZimaOS storage volume uses a different path.
OZSync compares local and remote file modification times:
- If the local file is newer, OZSync uploads it.
- If the remote file is newer, OZSync downloads it.
- Files in
.obsidian/,.trash/, and.ozsync-backups/are excluded.
Before OZSync overwrites an existing local file with a remote download, it saves the previous local copy under:
.ozsync-backups/YYYY-MM-DD-HHMMSS/
The plugin does not automatically propagate deletions during vault sync. Delete actions are only available in the cloud browser and require confirmation.
npm install
npm run check
npm run buildFor development rebuilds:
npm run devRelease tags must match manifest.json.version exactly. For example:
git tag 0.1.1
git push origin 0.1.1The GitHub Actions release workflow builds the plugin and uploads:
main.js
manifest.json
styles.css
Open issues at:
https://github.com/atopos31/OZSync/issues
Include your Obsidian version, plugin version, ZimaOS version, and relevant console logs. Do not include passwords or tokens.
MIT