AI Bridge

Read this in English | Przeczytaj w języku polskim

English

AI Bridge is an Obsidian plugin that seamlessly connects your local notes with Google NotebookLM, Google Gemini, and Google Search. It provides embedded desktop sidebar panels, smart folder-to-notebook mapping, right-click context menu shortcuts, and automatic query sending.

AI Bridge acts as a direct bridge — your data stays strictly between Obsidian and your Google account. No external proxy servers, no third-party API keys required.

💡 Philosophy: AI Bridge is a bridge between your vault and NotebookLM. Your results are as good as the sources you provide in your notebook. We recommend creating a dedicated NotebookLM notebook for each subject or research project containing specific publications, books, presentations, and transcripts.

✨ Key Features

1. Embedded Sidebar Webviews (Desktop)

   • Open NotebookLM and Gemini directly inside Obsidian's right sidebar.
   • Preserves your login session across restarts.
   • Clean header mode: hides promotional Google headers to maximize reading space.
   • Navigation toolbar: open in default browser, quick reload, settings shortcut, and support button.
   • Desktop focused: powered by native Electron Webviews with dedicated sessions.

2. Context Menu Actions (Right-Click / Touch)

   • Highlight any text in your note and right-click:
     • 📓 NotebookLM: copies selection to clipboard (optional) and loads the mapped or default notebook in the sidebar.
     • ✨ Gemini: sends the selected text directly to the Gemini sidebar chat.
     • 🔍 Google: opens a Google search for the selected text in your default browser.

3. Smart NotebookLM Mapping

   • Default Notebook: designate a primary notebook for unassigned notes.
   • Vault Auto-Matching: automatically scans your vault folders/files and suggests matching notebooks.
   • Folder & Note Rules: map specific folders or files to dedicated notebooks.
   • Frontmatter Support: set notebooklm: Notebook Name or notebook_id: <ID> in your note's YAML frontmatter.

4. Notebook Management & Verification

   • Add notebooks by pasting full URLs (https://notebooklm.google.com/notebook/...) or raw IDs.
   • Automatic notebook title fetching in the background.
   • Status indicators: 🟢 Verified, ⚪ Unverified, 🔴 Error / Inaccessible.
   • Optional automatic removal of deleted/invalid notebooks.

5. Configurable Query Automation

   • Auto-send queries: automatically sends queries to the chat box or only pre-fills them for review.
   • Clipboard control: toggle whether selected text is copied to your system clipboard.
   • Custom Google search URL: customize your preferred search provider URL.

6. Multi-Language Support (11 Languages)

   • Fully localized interface in English (en), Polish (pl), German (de), Spanish (es), French (fr), Simplified Chinese (zh), Japanese (ja), Korean (ko), Portuguese (pt), Russian (ru), and Italian (it).
   • Automatically adapts to Obsidian's display language or can be set manually in settings.

⌨️ Commands & Hotkeys

You can bind hotkeys to any of these commands in Obsidian (Settings → Hotkeys):

🛠️ Installation

Manual Installation:

1. Download main.js, manifest.json, and styles.css from the latest release.
2. In your Obsidian vault folder, create: .obsidian/plugins/ai-bridge/
3. Copy the downloaded files into that folder.
4. Reload Obsidian, go to Settings → Community plugins, and enable AI Bridge.

☕ Support

AI Bridge is free and open-source. If it improves your study workflow and daily research, consider buying me a coffee:

👉 Buy Me a Coffee (cesemess)

Polski

AI Bridge to wtyczka dla aplikacji Obsidian, która łączy Twoje lokalne notatki z Google NotebookLM, asystentem Gemini oraz wyszukiwarką Google. Oferuje zintegrowane panele boczne Webview na komputerze, inteligentne mapowanie folderów i notatek do notesów, szybkie akcje w menu kontekstowym oraz automatyczne przesyłanie zapytań.

AI Bridge działa jako bezpośredni most — Twoje dane pozostają wyłącznie pomiędzy Twoim skarbcem Obsidian a Twoim kontem Google. Brak zewnętrznych serwerów proxy i brak konieczności podawania kluczy API.

💡 Filozofia działania: AI Bridge stanowi most między Twoim skarbcem a NotebookLM. Otrzymywane odpowiedzi są tak dobre, jak materiały źródłowe przygotowane w danym notatniku. Zalecamy stworzenie osobnego notatnika NotebookLM dla każdego przedmiotu lub projektu badawczego i załadowanie do niego rzetelnych publikacji, podręczników, prezentacji oraz transkrypcji wykładów.

✨ Główne możliwości

1. Wbudowane panele boczne (Desktop Webview)

   • Otwieraj NotebookLM oraz Gemini bezpośrednio w prawym panelu bocznym Obsidiana.
   • Pamięta sesję logowania Google pomiędzy ponownymi uruchomieniami aplikacji.
   • Tryb czystego nagłówka: ukrywa zbędne banery promocyjne Google, zwiększając czytelność.
   • Pasek narzędzi: otwieranie w przeglądarce systemowej, odświeżanie, skrót do ustawień i wsparcie twórcy.
   • Dedykowana dla komputerów: wykorzystuje natywne panele Electron Webview z bezpieczną, izolowaną sesją logowania.

2. Menu pod prawym przyciskiem myszy (PPM / Dotyk)

   • Zaznacz dowolny fragment tekstu w notatce:
     • 📓 NotebookLM — kopiuje zaznaczenie do schowka (opcjonalnie) i ładuje powiązany notatnik w panelu bocznym.
     • ✨ Gemini — wkleja zaznaczone zapytanie bezpośrednio do czatu Gemini w panelu bocznym.
     • 🔍 Google — uruchamia wyszukiwanie zaznaczonego hasła w Twojej domyślnej przeglądarce.

3. Inteligentne mapowanie notatek (Smart Mapping)

   • Domyślny notatnik: wyznacz jeden notatnik główny dla wszystkich nieprzypisanych notatek.
   • Automatyczne dopasowywanie (Auto-Match): przeszukuje skarbiec i proponuje powiązanie folderów lub plików o nazwach zgodnych z notatnikami.
   • Reguły folderów i plików: twórz stałe powiązania folderów i plików z odpowiednimi notatnikami w tabeli reguł.
   • Obsługa Frontmatter: wpisz w nagłówku YAML notatki notebooklm: Nazwa Notatnika lub notebook_id: <ID>.

4. Zarządzanie notatnikami NotebookLM

   • Dodawanie notatników przez wklejenie pełnego linku (https://notebooklm.google.com/notebook/...) lub samego ID.
   • Automatyczne pobieranie tytułu notatnika w tle.
   • Wskaźniki statusu: 🟢 Zweryfikowany, ⚪ Niezweryfikowany, 🔴 Błąd / Brak dostępu.
   • Opcja automatycznego usuwania usuniętych/niedostępnych notatników.

5. Konfigurowalna automatyzacja zapytań

   • Automatyczne wysyłanie: wybierz, czy zapytania mają być automatycznie wysyłane, czy tylko wklejane do pola czatu.
   • Kontrola schowka: decyduj, czy zaznaczony tekst ma być kopiowany do schowka systemowego.
   • Własny adres URL wyszukiwarki: dostosuj adres URL dla wyszukiwania Google.

6. Pełna wielojęzyczność (11 języków)

   • Cały interfejs, powiadomienia i wskazówki przetłumaczone na: angielski (en), polski (pl), niemiecki (de), hiszpański (es), francuski (fr), chiński uproszczony (zh), japoński (ja), koreański (ko), portugalski (pt), rosyjski (ru) oraz włoski (it).
   • Automatyczne dostosowanie do języka aplikacji Obsidian z możliwością ręcznego wyboru w zakładce „Informacje”.

⌨️ Skróty klawiszowe

Wszystkie polecenia możesz przypisać do własnych skrótów klawiszowych w Ustawienia → Skróty klawiszowe:

• NotebookLM: Otwórz panel boczny
• Gemini: Otwórz panel boczny
• NotebookLM: Wyślij zaznaczenie do panelu bocznego
• Gemini: Wyślij zaznaczenie do Gemini w panelu bocznym
• Google: Szukaj zaznaczenia w zewnętrznej przeglądarce

🛠️ Instalacja ręczna

1. Pobierz pliki main.js, manifest.json oraz styles.css z najnowszego wydania (Releases).
2. W folderze swojego skarbca Obsidian przejdź do: .obsidian/plugins/ai-bridge/
3. Skopiuj pobrane pliki do tego folderu.
4. Uruchom ponownie Obsidian, wejdź w Ustawienia → Wtyczki społeczności i włącz AI Bridge.

☕ Wsparcie projektu

Wtyczka jest w 100% bezpłatna i otwartoźródłowa. Jeśli ułatwia Ci codzienną naukę i organizację notatek:

👉 Postaw mi kawę na Buy Me a Coffee

📄 Licencja / License

Distributed under the MIT License. See LICENSE for more information.