Obsidian Plugins#
1 Self-Hosted LiveSync#
- Database: couchDB
- Hosted on MMDocker at:
10.1.2.230/home/marc/docker-compose/obsidian-couchdb - Passwords in Obsidian note in 1Password
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