NotesBar

Quick access to your Obsidian notes, right from your macOS menu bar.

NotesBar is a modern macOS menu bar application designed for Obsidian users who want lightning-fast access to their knowledge base without switching contexts.

---

✨ Key Features

• 🚀 Blazing Fast Access: Open any note in your vault with just a few clicks from your menu bar.
• 📁 Multiple Vault Support: Easily switch between different Obsidian vaults.
• 🔍 Instant Smart Search: Find notes instantly with real-time search results across your selected vault.
• 📂 Intuitive File Browser: Navigate your vault's folder structure directly within the app.
• 👀 Quick Markdown Preview: Hover over a note in the list to see its contents without opening Obsidian.
• 🔗 Seamless Obsidian Integration: Leverages Obsidian's URI scheme for smooth note opening.
• 🎨 Canvas Creator: Create new Obsidian canvases with a single click.
• 🔒 Secure Vault Handling: Uses security-scoped bookmarks for safe and persistent access to your vault files.
• 🎨 Native macOS Experience: Built with SwiftUI for a modern, native look and feel that blends perfectly with macOS.

---

💡 Why Use NotesBar?

Are you tired of interrupting your workflow to open Obsidian just to quickly reference a note? NotesBar solves this by putting your most important information just a click away in your menu bar. It's perfect for:

• Quickly jotting down a thought in a daily note.
• Finding that specific code snippet or command.
• Referencing meeting notes or project details during calls.
• Seamlessly navigating your most frequently used notes.

---

⬇️ Installation

Requirements

• macOS 12.0 or later
• Obsidian installed

Steps

1. Download: Get the latest .dmg or .zip file from the Releases page.
2. Install: Open the downloaded file and drag NotesBar.app into your Applications folder.
3. Launch: Open NotesBar from your Applications folder or Launchpad.
4. Select Vault: Click the NotesBar icon that appears in your menu bar. The first time, you will be prompted to select your Obsidian vault folder. You can change or add vaults later via the app's settings.

---

🚀 Usage

1. Access: Click the NotesBar icon in your menu bar.
2. Navigate: Use the file browser on the left or the search bar at the top.
3. Search: Type keywords into the search bar to filter notes instantly.
4. Preview: Hover your mouse cursor over a note in the list to see a markdown preview of its content.
5. Open: Click on any note in the list to open it directly in Obsidian.

---

💻 Development

Interested in contributing or building from source?

Requirements

• Xcode 14.0 or later

Setup

1. Clone: Clone the repository to your local machine:

   git clone https://github.com/aman-senpai/NotesBar.git

2. Navigate: Change directory into the cloned repository:

   cd NotesBar

3. Open Project: Open the project in Xcode:

   open NotesBar.xcodeproj

4. Build & Run: Build and run the project using ⌘R in Xcode.

---

🙌 Contributing

Contributions are highly welcome! Whether it's submitting bug reports, suggesting new features, or opening pull requests, your help is appreciated.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request describing your changes.

Please ensure your code adheres to the project's style and passes any tests.

---

🙏 Acknowledgments

• Obsidian – For creating the incredible note-taking ecosystem.
• Down – For providing a fantastic Markdown rendering library.
• The vibrant SwiftUI and macOS development communities – For endless inspiration and resources.