Obsidian Plugin

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

  1. Check the plugin is enabled in Obsidian settings
  2. Verify your internet connection
  3. Check the Obsidian console for error messages
  4. 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.