Note Companion

by nexus-jpf
5
4
3
2
1
Score: 68/100

Description

The Note Companion plugin combines AI chat, transcription and file organization in one workflow for turning rough captures into cleaner notes. It can transcribe YouTube videos plus local audio or video files, chat with vault context using files, folders and tags, suggest folders, tags, titles and formatting for messy notes, and enhance meeting notes with transcripts, discussion points and action items. The plugin supports Note Companion Cloud as well as a self hosted backend, and it can run with several model providers including OpenAI, Claude, Gemini, Groq and local Ollama based setups. It stays desktop only, with setup paths that change depending on whether AI runs through the hosted service or infrastructure you control yourself.

Reviews

No reviews yet.

Stats

873
stars
44,250
downloads
115
forks
173
days
2
days
2
days
378
total PRs
0
open PRs
63
closed PRs
315
merged PRs
196
total issues
2
open issues
194
closed issues
555
commits

RequirementsExperimental

  • Note Companion Cloud account and license key, or a self-hosted Note Companion backend

  • AI provider API keys for self-hosted mode

Latest Version

3 days ago

Changelog

3.6.45 - Sharper Study Cards

Generate more focused, varied flashcards from your notes with improved fact coverage, less repetition, and a maximum of 30 cards per source. Questions now better distinguish individual concepts while staying grounded in the original content.

Technical Changes

  • Adjusted flashcard generation to target roughly one card per two to three sentences, with fewer cards for repetitive content.
  • Limited generated flashcards to a maximum of 30 per source.
  • Improved guidance to avoid duplicate facts, redundant questions, and overly broad comparisons.
  • Refined question-writing rules to prioritize distinct, testable facts and meaningful concept explanations.

SHA-256 Checksums

1ce8903e6b15360691a3ed5fc559c220d45184181798114dcbb4b3e98cad11eb main.js 2032ae52a5cd29fc4f6248c6903ea03da2e704dd0c10e3764559991a4b82d782 styles.css 3df47478925e1c5f0d2bac5d21f365994ddcb353a52c3aa3f6bf7605042bacc6 manifest.json

README file from

Github

Note Companion (formerly File Organizer 2000)

Turn messy captures into clean, searchable notes — transcribe audio/YouTube, chat with your vault, and auto-organize files right inside Obsidian. Works with Note Companion Cloud or a self-hosted backend where you configure your own AI provider keys.

✅ Best for: researchers, students, meeting-heavy workflows, and anyone with an "Inbox" full of unprocessed notes.


What you can do

  • 🎬 Transcribe YouTube videos (multi-language, works even when captions aren't available in the usual way)
  • 🎙️ Transcribe audio & video files (handles large files reliably)
  • 🧠 Chat with your notes using vault context (mention files/folders/tags)
  • 🗂️ Auto-organize & format notes (folder/tag/title/template suggestions; optional "Inbox" automation)
  • 🧾 Meeting recorder → Enhance note (transcript, discussion points, action items, embedded audio)
  • 🔌 Multiple AI providers: OpenAI, Claude, Gemini, Groq, Ollama/local models, and custom base URLs
  • 🏠 Self-hosting supported (Docker + service examples)

Screenshots

File Organization Interface

AI-powered tags, folders, and formatting suggestions

YouTube Transcription Workflow

YouTube link → Transcript + Summary + Structured Notes

AI Chat with Vault Context

Chat with your notes using @mentions for files, folders, and tags


Install

Obsidian → Settings → Community plugins → Browse → "Note Companion" → Install → Enable

Platform support (Obsidian)

This plugin is for Obsidian on desktop only (Windows, macOS, and Linux). It is marked desktop-only in the plugin manifest, so Obsidian on iPhone, iPad, and Android will not load it and may show it as unsupported on mobile.

The plugin is built and tested for desktop Obsidian. Some features assume a typical desktop environment (for example, certain local integrations). We do not test or support the Obsidian plugin on mobile today.

Related: This repo also includes a separate Note Companion mobile app for capture and cloud-backed workflows. Development on that app is currently on pause. It is not a replacement for running the Obsidian plugin inside the mobile Obsidian app.


Setup

Open Settings → Note Companion and choose one of the paths below.

Important: The Obsidian plugin does not have a screen to paste OpenAI / Claude / Gemini API keys directly. Those keys are configured on your self-hosted backend (see path 2). The plugin's License Key field is for Note Companion Cloud access only.

Path 1 — Note Companion Cloud (default)

  1. Create an account at notecompanion.ai or sign up / sign in from the plugin's General tab
  2. Copy your license key from the web dashboard (API Keys) and paste it into Settings → Note Companion → General → License Key
  3. Click Activate

No cloud account is required for self-hosting (path 2).

Path 2 — Self-hosted / bring your own provider keys

Use this path to run AI through your own OpenAI, Claude, Gemini, Groq, or compatible API keys.

  1. Deploy the Note Companion backend — see SELF-HOSTING.md (Docker or pnpm build:self-host)
  2. Add provider keys to the server .env (e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY, MODEL_PROVIDER, MODEL_NAME; optional OPENAI_API_BASE for Ollama or other OpenAI-compatible endpoints)
  3. In Obsidian: Settings → Note Companion → Advanced → Enable Self-Hosting
  4. Set Server URL to your backend (e.g. http://localhost:3000)
  5. Leave License Key empty or use any placeholder — self-hosted instances with ENABLE_USER_MANAGEMENT=false do not require a cloud license

Path 3 — Local Ollama (chat only, experimental)

  1. Run Ollama locally
  2. Self-host the backend with OPENAI_API_BASE=http://localhost:11434/v1, or enable Experiment → Local LLM Integration in plugin settings (requires Catalyst access for the in-plugin Ollama path)
  3. Select the local model in the chat model picker

Quick test

  • Open Command Palette → Note Companion: Open Chat
  • Ask: "Summarize this note and suggest tags"

Quick workflows

1) YouTube → Note

  1. Copy a YouTube link
  2. In Note Companion Chat, paste the link with what you want done — e.g. summarize https://www.youtube.com/watch?v=... (a bare link on its own is not an instruction)
  3. Get transcript + summary + optional structured notes

2) Audio recording → Meeting note (best demo)

  1. Open Meetings tab → Start Recording
  2. Stop Recording → select a note → Enhance Note
  3. You'll get:
    • embedded audio
    • transcript
    • discussion points + action items

3) Inbox auto-organization

  1. Create an Inbox folder (configured in settings)
  2. Drop raw notes / links inside
  3. Note Companion suggests (or auto-applies) folder + tags + title + formatting

Providers & privacy

Mode Where provider keys live Plugin configuration
Note Companion Cloud Note Companion servers License key in General tab
Self-hosted (BYOK) Your server .env Advanced → Self-Hosting + Server URL
Local Ollama Your machine (Ollama) Self-hosted OPENAI_API_BASE and/or Experiment → Local LLM

Your data handling depends on the mode you choose. View our full privacy policy at notecompanion.ai/privacy

Cloud Service:

  • Files are processed through our secure API for AI analysis
  • Usage statistics collected for billing and rate limits
  • Your vault content remains private and is only processed when you explicitly use plugin features
  • Account sign-in on the web dashboard may offer Google OAuth (Clerk); the in-plugin sign-up uses email/password

Self-hosted / your provider keys:

  • Provider keys are set on the backend, not in the Obsidian plugin UI
  • All AI processing runs on infrastructure you control
  • No cloud usage tracking when ENABLE_USER_MANAGEMENT=false

Self-hosting

Want full control and local infrastructure?

➡️ See SELF-HOSTING.md for Docker + service setups and security notes.


Troubleshooting

If transcription fails:

  • Check provider key, model availability, and file size limits
  • Verify API key is valid and has sufficient credits
  • For large files (>25MB), consider splitting or compressing

If YouTube import fails:

  • Try a different fallback method
  • Ensure the video is accessible and not private/restricted
  • Check network connectivity

If local model doesn't respond:

  • Verify Base URL and CORS/network settings
  • Ensure the local server (e.g., Ollama) is running
  • Check firewall settings

If plugin can't connect to server:

  • Verify Server URL under Settings → Note Companion → Advanced (check for typos, trailing slashes, http vs https)
  • Confirm the backend is running (curl http://localhost:3000/api/health or your configured URL)
  • Check firewall/network settings

If chat doesn't work:

  • Cloud: verify your license key is activated in General
  • Self-hosted: verify provider keys and MODEL_PROVIDER / MODEL_NAME in the server .env, and that self-hosting is enabled in Advanced
  • Check model availability for your provider
  • Enable Debug Mode in Advanced and review logs there

Support / feedback


For developers

If you want to build or contribute, start here: CONTRIBUTING.md


Important Disclosures

Account & Payment Requirements

  • Payment required for cloud service: The plugin requires a paid subscription to use the cloud-hosted service
  • 7-day free trial: New subscriptions include a 7-day trial period
  • Self-hosting option available: You can run your own instance for free (see Self-Hosting above)
  • Account creation: Using the cloud service requires creating an account at notecompanion.ai

Network Usage

This plugin communicates with the following remote services:

  • Note Companion API Server (cloud service): For AI-powered features including file classification, formatting, transcription, and chat
  • YouTube API: For fetching video transcripts when processing YouTube links
  • AI Provider APIs: When self-hosting or using your own keys, you'll connect directly to your chosen AI provider (OpenAI, Anthropic, Google, etc.)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Agent Client
6 months ago by rait-09
Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.
Alias Management
3 years ago by WithMarcel
Identify duplicate notes based on similar aliases and filenames in Obsidian.
Attachment Management
3 years ago by trganda
Attachment Management of Obsidian
Attachment Manager
3 years ago by chenfeicqq
Attachment folder name binding note name, automatically rename, automatically delete, show/hide.
Audio Notes
4 years ago by Jason Maldonis
Easily take notes on podcasts and other audio files using Obsidian Audio Notes.
AudioPen Sync
2 years ago by Jonas Haefele
Connect AudioPen to Obsidian
Auto Folder Note Paste
2 years ago by d7sd6u
Convert your note into folder note upon pasting or drag'n'dropping an attachment
AutoMover
2 years ago by Al0cam
Move files and notes with specified names into their designated folders according to rules you define.
AXXA Agent
2 months ago by AXXA Lab™
AI chat, Vault Q&A and an agent that edits your notes, built mobile-first. OpenAI, Claude, Gemini, OpenRouter, NVIDIA NIM or local Ollama, with your own API key. Obsidian plugin.
Bulk Rename
4 years ago by Oleg Lustenko
Claudian
4 months ago by Yishen Tu
An Obsidian plugin that embeds Claude Code, Codex and other agents as an AI collaborator in your vault.
Clone Vault
2 years ago by Sebastian Baroni
Clones the current Obsidian vault by copying settings and folder structure without note contents.
Convert url to preview (iframe)
6 months ago by fhachez
Plugin for Obsidian.md to convert a selected URL to an iframe.
Copilot
4 years ago by Logan Yang
Run agents in Obsidian - OpenCode, Codex, Claude Code etc.
Custom File Explorer sorting
4 years ago by SebastianMC
Take full control over the order and sorting of folders and notes in File Explorer in Obsidian
Daily Named Folder
5 years ago by Nemo Andrea
Like daily note, but nested in a daily folder and some more improvements
Daily Notes Automater
2 years ago by David Pedrero
DeepSeek Harness Native
3 months ago by wuruihi
Obsidian 侧边栏内驱动本地 DeepSeek Harness (DSH) Web GUI,支持 vault 双向桥接与 DSH 服务自动管理。
Enhance YouTube Links
3 years ago by GitSum
Take a YouTube link and get the title and optionally channel name, channel URL, and thumbnailURL.
Epiphany
2 years ago by Epiphany
ExMemo Tools
2 years ago by Yan.Xie
Use large models for smart document management and optimization, including relocating files, enhancing text, and generating metadata.
Folder by tags distributor
2 years ago by RevoTale
Automatically group Obsidian notes into folder by tags specified in note.
Folder Index
5 years ago by turulix
FolderFile Splitter
2 years ago by Xu Quan
Geulo
2 years ago by Junyoung Bang
Geulo — an Obsidian plugin for pulling and syncing your liked YouTube videos to your Obsidian vault.
Gladdis
3 years ago by Aurélien Stébé
Gladdis (Generative Language Artificial Dedicated & Diligent Intelligence System) - it's an AI chatbot.
ICOR for Life - Chat
3 months ago by Paperless Movement S.L.
Talk to your AI team where the knowledge lives. A Claude chat inside the vault: it sees the note you have open and the text you selected, answers in readable ICOR cards, and archives your sessions as notes. Part of the ICOR for Life suite.
Local LLM Hub
4 months ago by TAKESHI MORITA
All-in-one local AI hub for Obsidian — LLM chat with vault tools, MCP servers, RAG, workflow automation, encryption, and edit history. Fully private, no cloud required.
Neural Composer
4 months ago by Oscar Campo
AI-Powered Graph Memory for Obsidian
Note Player
24 days ago by xia-ataraxia
Obsidian plugin that plays note-backed playlists with YouTube (via yt-dlp), cached audio, and local files.
Offline Whisper Transcription
4 months ago by David Manthey
Personal Assistant
6 months ago by edonyzpc
A plugin that harnesses AI agents and streamlining techniques to help you automatically manage Obsidian.
Project Browser
3 years ago by Dale de Silva
Qiaomu Reader
2 months ago by 向阳乔木
已上架 Obsidian 社区插件市场:搜索 Qiaomu Reader 安装。Read EPUB, PDF and MOBI, highlight passages, keep linked notes and ask optional AI.
RSS Dashboard
10 months ago by Aditya Amatya
A dashboard for organizing and consuming RSS feeds, YouTube channels, and podcasts with smart tagging, media playback, and seamless content flow.
Sidet
4 months ago by Jiao Yingxing
流畅自然的 AI 对话体验,移动端也出色。A smooth, natural AI chat experience that also works great on mobile.
Smart Link Formatter
a year ago by ccmdi
Obsidian plugin that automatically formats links with information from dynamic websites
Star Gate
4 months ago by starhunter
obsidian gate plugin
SystemSculpt AI
5 months ago by systemsculpt
Chat with your Obsidian vault using your own Claude Code or Codex on desktop, or hosted AI. Edit notes with approval modes, transcribe audio and find related notes. Free to start.
Thumbnails
4 years ago by Michael Harris
Add youtube thumbnails into your obsidian notes
TikToker
8 months ago by ameyxd
A Tiktok parser and saver for Obsidian
Timecodes
2 years ago by Kirill Gavrilov
Makes timecodes clickable, if there was a video URL mentioned earlier in Obsidian note
Transcription
4 years ago by djmango (Sulaiman Ghori)
Obsidian plugin to create high-quality transcriptions from markdown linked audio files
Workbuddian
3 months ago by jiang198012
Obsidian 插件:把本地 CodeBuddy CLI 或 Hermes agent 变成 vault 内 AI 聊天——流式回复、@引用、双后端切换。Obsidian plugin turning local CodeBuddy CLI or Hermes agent into an in-vault AI chat with streaming, @-references, and dual backends.
WorkBuddy
3 months ago by Jason
obsidian plugin for workbuddy
YouTube downloader
2 years ago by Blake Chan
download video from youtube
Youtube Iframe Timestamps
2 years ago by Nils Leo
Obsidian plugin to embed YouTube videos with clickable timestamps. Take video notes seamlessly without leaving your vault.
Youtube Summarizer
3 years ago by ozdemir08
YouTube Template
3 years ago by sundevista
📺 A plugin that would help you to fetch YouTube videos data into your vault.
YouTube Video Summarizer
2 years ago by mbramani
Generate AI-powered summaries of YouTube videos directly in Obsidian using Google's Gemini AI.
YTranscript
4 years ago by Łukasz Strzępek
YTSummarizer
2 years ago by Arda Kalaycı