Mobile
Engram Vault Sync supports Obsidian on iOS and Android. The plugin runs the same sync engine but operates under tighter constraints than desktop.
What works
Section titled “What works”- Real-time push and pull, same as desktop
- Conflict detection and resolution UI
- Semantic search via command palette
- Sync Center
Mobile-specific behavior
Section titled “Mobile-specific behavior”- Background sync is limited by the OS — iOS in particular may pause the plugin when Obsidian is backgrounded. Sync resumes the moment you re-open the app.
- Path sanitization — the backend strips the following characters
from any incoming path:
\,:,*,?,<,>,",|. Consecutive spaces collapse to one. Each path segment is capped at 255 bytes (filesystem limit). A note created on desktop with one of those characters in its filename arrives renamed on mobile. The plugin handles the rename transparently when pulling. - Initial sync over cellular can chew bandwidth fast. Prefer Wi-Fi for the first push of a big vault.
Setup notes
Section titled “Setup notes”The setup flow is identical: Settings → Community plugins → enable Engram Vault Sync → Engram: Sign in. OAuth opens in the system browser; iOS/Android will hand the token back to Obsidian via the custom URL scheme.
Hide synced media from the gallery (Android)
Section titled “Hide synced media from the gallery (Android)”If your vault contains images, audio, or video, Android’s media scanner picks them up by default — they show up in Gallery and Photos apps next to your real photos. To hide them:
- With a file manager, navigate to your Obsidian vault folder on device storage.
- Create an empty file named
.nomedia(note the leading dot) at the root of the vault. - Restart the gallery app or reboot — Android’s media scanner now skips the vault and every subfolder.
iOS has no direct equivalent and doesn’t need one: third-party app storage is sandboxed and iOS apps don’t expose files to Photos unless the app explicitly opts in. Obsidian doesn’t.
Known limitations
Section titled “Known limitations”- Selective sync (pick which folders or paths to push/pull) is on the plugin roadmap but not yet shipped. The plugin currently syncs the full vault (minus ignore patterns).
- Canvas files sync but can be slow to render in mobile Obsidian. Engram syncs the underlying JSON regardless.
Next: Troubleshooting.