Skip to content

Customisation Sync, not Hidden File Sync, for the tablet's interface - #84

Merged
mathewcsims merged 1 commit into
mainfrom
customisation-sync-not-hidden-file-sync
Aug 13, 2026
Merged

Customisation Sync, not Hidden File Sync, for the tablet's interface#84
mathewcsims merged 1 commit into
mainfrom
customisation-sync-not-hidden-file-sync

Conversation

@mathewcsims

Copy link
Copy Markdown
Owner

Follow-up to #82 and #83. Both compose.yaml and SETUP.md named Hidden File Sync as the way the stripped-back interface reaches the Android tablet. Not false — it does cover .obsidian/ — but it points at the wrong one of LiveSync's two overlapping features for this setup.

Why it matters

Upstream is explicit that the two are not to be mixed:

"Hidden File Sync is a separate feature with different setup, selection, and conflict behaviour; do not use both features to manage the same files."

They resolve conflicts differently, so running both over the same content is a way to lose settings — which makes "which one" a real decision rather than a naming detail.

Why Customisation Sync

Hidden File Sync Customisation Sync
What it does Syncs files under .obsidian/ as files Syncs plugins, themes, snippets and config, per device
Device model Same content everywhere Named devices; choose whose config applies where
Right here No Yes

The device model is the whole argument. Two Macs and a tablet are not three copies of one machine: the tablet shouldn't be loading desktop-only plugins, and Hidden File Sync mirrors .obsidian/ wholesale with no lever for that. Customisation Sync pins state to a named device and applies it deliberately — also upstream's own recommendation for getting a desktop plugin setup onto mobile.

Also captured

  • Name devices before applying anything, or you can't tell whose config you're pushing.
  • Ordering constraint: enable only once plain note sync works on all three devices. Upstream's rebuild/fetch operations deliberately leave these off. Turning it on during setup gives you a sync problem and a config problem simultaneously, with no way to tell them apart.

Not verified

Neither feature has been run on this instance, and upstream's docs/hidden_file_sync.md is a 404 — this comes from docs/settings.md and the maintainer's discussion threads. Flagged inline in SETUP.md rather than presented as tested.

Comments and docs only; compose.yaml re-checked with podman compose config. No behaviour change.

🤖 Generated with Claude Code

Both compose.yaml and SETUP.md named Hidden File Sync as the way the
stripped-back interface reaches the Android tablet. Not false — it does cover
.obsidian/ — but it points at the wrong one of LiveSync's two overlapping
features for this setup.

Upstream is explicit that they are not to be mixed: "Hidden File Sync is a
separate feature with different setup, selection, and conflict behaviour; do
not use both features to manage the same files." They resolve conflicts
differently, so running both over the same content is a way to lose settings.

Customisation Sync is the right one here because it is device-aware. Two Macs
and a tablet are not three copies of one machine: the tablet should not be
loading desktop-only plugins, and Hidden File Sync mirrors .obsidian/
wholesale with no lever for that. Customisation Sync pins state to a named
device and applies it deliberately, which is also upstream's own
recommendation for getting a desktop plugin setup onto mobile.

Adds a "Syncing the interface itself" section covering the distinction, the
requirement to name devices before applying anything, and the ordering
constraint — enable it only once plain note sync works on all three devices,
since doing it during setup gives you a sync problem and a config problem at
once with no way to tell them apart.

Marked as not verified: neither feature has been run on this instance, and
upstream's docs/hidden_file_sync.md is a 404, so this comes from
docs/settings.md and the maintainer's discussion threads.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mathewcsims
mathewcsims merged commit 4d20205 into main Aug 13, 2026
7 checks passed
@mathewcsims
mathewcsims deleted the customisation-sync-not-hidden-file-sync branch August 13, 2026 22:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant