Support

Welcome to the Obsidian Floating Notes support center. Here you'll find answers to common questions and troubleshooting guidance.

Frequently Asked Questions

Installation & Setup

Q: What are the system requirements?

A: Obsidian Floating Notes requires macOS 12.0 (Monterey) or later, and Obsidian installed with at least one vault configured.

Q: How do I grant the necessary permissions?

A: On first launch, the app will request permission to access your Obsidian configuration folder and vault folders. Grant these permissions when prompted. If your vaults are in non-standard locations, you may need to grant additional permissions through System Preferences.

Q: The app isn't detecting my vaults

A: Try these steps:

Ensure Obsidian is installed and has been opened at least once
Check the Permissions section in the app settings
Grant access to the Obsidian configuration folder (~/Library/Application Support/obsidian)
If vaults are in custom locations, grant access to those folders specifically

Usage & Features

Q: How do I configure global keyboard shortcuts?

A: Open the app settings using ⌘, or right-click the menu bar icon and select "Settings". In the "General" section, you can configure global shortcuts for:

Toggle floating window
Quick capture (new note)
Create new note
Search notes

Q: Can I use multiple vaults?

A: Yes! Obsidian Floating Notes supports multiple vaults. You can switch between vaults in the menu bar dropdown or in the app settings. The app remembers your recent notes for each vault separately.

Q: Does it work with iCloud vaults?

A: Yes, the app works seamlessly with vaults stored in iCloud Drive. Just ensure you have granted the necessary permissions to access your iCloud folder.

Troubleshooting

Q: Notes aren't saving

A: If your notes aren't saving:

Check that you have write access to the vault folder
Verify the vault isn't stored in a read-only location
If using iCloud, ensure the vault is fully synced
Try restarting the app and checking permissions

Q: The app crashes or freezes

A: Try these troubleshooting steps:

Restart the app
Check if you're running the latest version
Try resetting app preferences in the settings
Ensure you have sufficient disk space
Check macOS System Console for any error messages

Q: Font warnings in console

A: You may see warnings about sandbox extensions for fonts in the console. These are harmless and don't affect the app's functionality. They're related to macOS sandbox security and can be safely ignored.

Keyboard Shortcuts

Global Shortcuts (configurable)

Toggle floating window: Configurable in settings
Quick capture: Configurable in settings
New note: Configurable in settings
Search notes: Configurable in settings

Window Shortcuts

⌘W: Close window
⌘N: New note
⌘P: Open note switcher
⌘,: Open settings
⌘O: Open in Obsidian
⌘R: Refresh notes
Esc: Close window

Editor Shortcuts

⌘B: Bold
⌘I: Italic
⌘U: Underline
⌘K: Insert link
⌘⇧K: Insert image
⌘`: Inline code
⌘L: Bullet list
⌘⇧L: Numbered list
⌘⇧X: Strikethrough
⌘1-6: Headings 1-6

Getting Help

Contact Support

If you can't find the answer to your question here, please don't hesitate to contact us:

Email: [email protected]
Response Time: We typically respond within 24-48 hours

Report a Bug

When reporting bugs, please include:

macOS version
Obsidian Floating Notes version
Steps to reproduce the issue
Expected vs. actual behavior
Any error messages (screenshots helpful)

Feature Requests

We love hearing your ideas for improving Obsidian Floating Notes! Please email us with your suggestions, including:

What feature you'd like to see
How it would help your workflow
Any specific implementation ideas

Resources

Documentation

Pro Tip

For the best experience, set up global keyboard shortcuts that don't conflict with other apps. Consider using modifier combinations like ⌘⌥⌘ for quick access to your floating notes.