Obsidian Plugin Troubleshooting
Common issues with the Obsidian plugin and how to resolve them.
Common issues and solutions for the BrainTube Obsidian plugin.
API Key Issues
Generate a fresh key from Settings → API Keys. Make sure you copied the full key without trailing spaces. Keys are tied to your account.
Sync Not Starting
- Check the plugin is enabled in Obsidian settings
- Verify your internet connection
- Check the Obsidian console for error messages
- Try disabling and re-enabling the plugin
Notes Not Appearing in BrainTube
- Sync may take 30-60 seconds for processing
- Check your sync folder settings
- Notes with only frontmatter (no content) may be skipped
Formatting Problems
- Obsidian-specific syntax (callouts) is preserved as-is
- Wikilinks are converted to standard markdown links
- Embedded files and images are referenced but not uploaded
Plugin Updates
Enable auto-updates in Obsidian to get the latest fixes. Check the changelog for breaking changes before major updates.
Still need help? Email support.