Skip to content

Harden clean-Mac installation guidance #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
msinclair25 merged 1 commit into from
Aug 1, 2026
Merged

Harden clean-Mac installation guidance #7

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 24 additions & 12 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,12 @@ The normal alpha path starts in the authenticated OWD **Vaults** folder:
1. In Obsidian, open **Settings → Community plugins** and choose
**Turn on community plugins**. OWD cannot bypass this Obsidian security
consent.
2. Close Obsidian.
3. In OWD, choose **Install OWD Sync 0.1.6**.
4. In current Chrome or Edge, select the exact vault root in the browser's
folder picker and allow the requested local write access.
2. Fully quit Obsidian with **Obsidian → Quit Obsidian** or **⌘Q**. Closing the
macOS window is not enough.
3. In OWD, choose **Choose vault and install OWD Sync 0.1.6**.
4. In current Chrome or Edge, select the exact vault root containing your notes
and hidden `.obsidian` folder—not `.obsidian` itself—and choose **Allow** if
Chrome requests local write access.
5. Reopen Obsidian and confirm **OWD Sync** is enabled in that vault.
6. Return to OWD and create the private pairing request.

Expand All @@ -70,14 +72,24 @@ change general Obsidian settings, or install an updater.
Use [BRAT](https://github.com/TfTHacker/obsidian42-brat) as the disclosed
fallback:

1. Install and enable BRAT from Obsidian Community Plugins.
2. Add the beta plugin repository `msinclair25/owd-sync`.
3. Confirm Obsidian shows OWD Sync version `0.1.6`.
4. Enable OWD Sync under **Settings → Community plugins**.

BRAT is a testing bridge, not the permanent install experience. OWD Sync will
move to Obsidian Community Plugins after its compatibility, security, mobile,
update, and clean-install gates pass.
1. Reopen the exact vault where you want OWD Sync installed.
2. Install and enable BRAT from Obsidian Community Plugins, then wait until
BRAT appears in the Command Palette.
3. Open the version-pinned
[OWD Sync BRAT form](obsidian://brat?plugin=msinclair25/owd-sync&version=0.1.6).
This link opens BRAT's form; it does not finish the installation. Verify the
repository and version, choose **Add Plugin**, and wait for BRAT to finish.
4. Enable OWD Sync `0.1.6` under **Settings → Community plugins**.

If the prefilled link does nothing, run **BRAT: Plugins: Add a beta plugin for
testing (with or without version)** from the Command Palette, paste
`https://github.com/msinclair25/owd-sync`, select `0.1.6`, and choose **Add
Plugin**.

Use either the direct installer or BRAT, not both. BRAT is a testing bridge,
not the permanent install experience. OWD Sync will move to Obsidian Community
Plugins after its compatibility, security, mobile, update, and clean-install
gates pass.

## Pair one vault

Expand Down