Install guide

Which method

The directory and BRAT both download from GitHub and fail when GitHub is unreachable. Offline packages are hosted on this site and are identical to the files in the directory.

Method 1: Community directory

Theme: Settings → Appearance → Manage (next to Themes) → search gogoga → Install and use.

Plugins:

1. Settings → Community plugins, turn off Restricted mode.
2. Click Browse and search for the plugin, e.g. gogoga Mind Map.
3. Click Install, then Enable.

New versions show up under Community plugins → Check for updates.

Method 2: Offline package

1. Download

Get a zip from the download page or a plugin's page. The gogoga bundle has the theme and every listed plugin.

After unzipping:

• A plugin package holds one folder named after the plugin id, e.g. gogoga-mindmap/, with main.js, manifest.json and maybe styles.css.
• The theme package holds a gogoga/ folder with theme.css and manifest.json.
• The bundle holds a themes/ and a plugins/ folder.

2. Find the vault's .obsidian folder

Your vault is the folder your notes live in. Not sure where it is? Right-click any note in Obsidian's file list → Reveal in Finder (Show in system explorer on Windows).

The vault root contains a hidden .obsidian folder where themes and plugins live:

• macOS: press ⌘ ⇧ . in Finder to show hidden files.
• Windows: File Explorer → View → Show → tick Hidden items.

3. Put the folders in place

your-vault/
└── .obsidian/
    ├── themes/
    │   └── gogoga/              ← theme folder
    │       ├── manifest.json
    │       └── theme.css
    └── plugins/
        ├── gogoga-mindmap/      ← one folder per plugin
        │   ├── main.js
        │   ├── manifest.json
        │   └── styles.css
        └── gogoga-table/
            └── …

• Create themes or plugins if they don't exist (lowercase).
• With the bundle, drag themes and plugins into .obsidian and choose Merge.
• Don't nest one level too deep: plugins/gogoga-mindmap/main.js, not plugins/gogoga-mindmap/gogoga-mindmap/main.js.

4. Enable

1. Quit and reopen Obsidian (or click the reload button under Community plugins).
2. Theme: Settings → Appearance → Themes, choose gogoga.
3. Plugins: Settings → Community plugins, turn off Restricted mode and switch each plugin on.

On a phone or tablet

Easiest: install on a computer and let sync carry it over.

• iCloud vaults: put the files into the vault's .obsidian on your Mac, wait for iCloud, then restart Obsidian on the phone and enable.
• Obsidian Sync: under Settings → Sync, turn on syncing for installed community plugins and appearance settings.
• Syncthing, Remotely Save and similar: make sure .obsidian isn't excluded.

Phone only:

• iPhone/iPad: the Files app hides folders starting with a dot, so use the community directory, or install on a computer and sync.
• Android: use a file manager that shows hidden files and copy the folder into vault/.obsidian/plugins/, then enable it in Obsidian.

Method 3: BRAT

BRAT installs and updates plugins straight from GitHub repositories, which suits unlisted plugins. It needs GitHub access.

1. Install and enable Obsidian42 - BRAT from the community directory.
2. Settings → BRAT → Add beta plugin (Add beta theme for themes).
3. Enter the repository, e.g. JackWeiGogoga/gogoga-fav-sync, keep Latest, and add it.

Updating

• From the directory: Community plugins → Check for updates.
• From an offline package: download the new zip, copy its files over the old folder, restart Obsidian. Settings live in data.json in the same folder; packages don't include it, so nothing is lost.
• Listed plugins installed offline can later update from the directory once GitHub is reachable; the two methods mix fine.

Verifying a download (optional)

Every zip's SHA-256 is listed on the download page and the plugin pages:

# macOS / Linux
shasum -a 256 gogoga-mindmap-0.61.8.zip

# Windows PowerShell
Get-FileHash gogoga-mindmap-0.61.8.zip