Obsidian Plugins#
1 Obsidian Git (Multi-Device Sync)#
We sync our vaults between desktop and laptop computers directly using the Obsidian Git plugin connecting to GitHub.
- Repository:
git@github.com:marcoue/obsidian-homelab.git - Shortcuts:
Cmd + S: Commit & Push local changes.Cmd + Shift + S: Pull remote changes.
- Auto-Syncing: Configured to pull on startup, pull updates in background every 5 minutes, and backup (commit/push) in background every 10 minutes.
1.1 [RETIRED] Self-Hosted LiveSync (CouchDB)#
Note: The CouchDB Docker container on MMDocker (10.1.2.230) has been stopped and disabled, and the plugin has been uninstalled from all vaults to avoid sync storms and deletion loops.#
2 Obsidian Terminal Plugin: Configuration Guide#
This guide details the setup for the Obsidian Terminal Plugin on a MacStudio (macOS) to ensure it correctly utilizes the modern Python environment and integrated Zsh shell.
2.1 Core Configuration#
To avoid the ImportError: cannot import name 'Self' from 'typing' error, you must point the plugin to your Homebrew-managed Python 3.14 instead of the outdated system version.
Profile Settings#
Open Settings > Terminal > MyProfile (or your default profile) and ensure the following fields are set:
| Field | Value | Notes |
|---|---|---|
| Type | Integrated |
Runs the terminal inside an Obsidian tab. |
| Executable | /bin/zsh |
Standard macOS shell. |
| Arguments | --login |
Ensures your .zshrc and paths are loaded. |
| Python executable | /opt/homebrew/bin/python3 |
Crucial: Points to the correct 3.14 environment. |
| Restore history | Enabled |
Saves your command log to .obsidian/workspace.json between sessions. |
| Follow theme | Enabled |
Automatically matches the terminal colors to your Obsidian workspace. |
| Check (Validation) | Click Button |
Use the document icon next to the Python path to verify the configuration is valid. |
2. Platform Toggles#
Platform Toggles#
Since this is a macOS-specific setup, disable unnecessary cross-platform hooks to prevent conflicts:
- macOS:
Enabled✅ - Linux:
Disabled❌ - Microsoft Windows:
Disabled❌ - Use Microsoft Windows ‘conhost.exe’:
Disabled❌
2.2 Essential Hotkeys#
When the terminal is focused, standard Obsidian hotkeys are temporarily disabled so they can be sent to the shell. Use the toggle below to jump back to note-taking mode.
- Toggle Focus (Terminal/Note): `Cmd + Shift + ``
- Find in Terminal:
Cmd + Shift + F - Clear Terminal:
Cmd + Shift + K - Close Terminal:
Cmd + Shift + W
3 Add exclusions to #AI#Copilot plugin for indexing#
public/**, resources/**, archetypes/**, data/**, layouts/**, static/**, themes/**, config.toml, hugo.toml, .hugo_build.lock, .git/**, .obsidian/**, .smart-env/**, node_modules/**, .DS_Store, **/*.css, **/*.js, **/*.json, **/*.html, **/*.xml
public, resources, archetypes, data, layouts, static, themes, node_modules, .git, .obsidian, .smart-env, .DS_Store, *.css, *.js, *.json, *.html, *.xml, *.toml, *.lock