8000 GitHub - muminkoykiran/Vocalog: ๐ŸŽ™๏ธ Obsidian AI Voice Notes & Audio Journal: Live mic recording, Whisper STT (Groq/OpenAI), and LLM-powered structured daily notes with transcript preservation. ยท GitHub
[go: up one dir, main page]

Skip to content
muminkoykiranPublic

About

๐ŸŽ™๏ธ Obsidian AI Voice Notes & Audio Journal: Live mic recording, Whisper STT (Groq/OpenAI), and LLM-powered structured daily notes with transcript preservation.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

ย 
ย 

Latest commit

ย 

History

21 Commits

Folders and files

Repository files navigation

๐ŸŽ™๏ธ Vocalog - AI Voice Notes & Audio Journal for Obsidian

GitHub Release License: MIT Obsidian PRs Welcome

Capture your thoughts at the speed of sound.
Vocalog is an Obsidian plugin that brings one-click live voice recording, lightning-fast Whisper speech-to-text (STT), and LLM-powered intelligent summarization directly into your daily notes and PKM workflow.


โšก Why Vocalog?

Most voice note solutions require you to record in an external app, export the audio, find a transcription service, paste the transcript into Obsidian, and manually organize it.

Vocalog automates the entire pipeline inside Obsidian:

  1. Speak: Click the ribbon mic icon to start live recording.
  2. Transcribe: Ultra-fast transcription via OpenAI Whisper, Groq, or local models.
  3. Synthesize: An LLM (DeepSeek, GPT-4o, Claude, Ollama) distills your speech into structured daily notes (actions, insights, summaries).
  4. Preserve: Raw verbatim transcripts are automatically kept in collapsible blocks so you never lose context.

โœจ Features

  • ๐ŸŽ™๏ธ In-App Live Microphone Recording: Record voice memos directly inside Obsidian without external tools.
  • ๐Ÿ”ด Active Visual Pulse Feedback: Ribbon button pulses with glowing red animation while recording is active.
  • ๐Ÿค– Custom AI Mic Studio Icon: Specially designed icon representing voice intelligence.
  • โšก Whisper Speech-to-Text Support: Compatible with any OpenAI-compatible audio transcription API (Groq Whisper, OpenAI Whisper, LocalAI, self-hosted).
  • ๐Ÿง  Smart LLM Summarization: Turns noisy speech into actionable Markdown journals, extracting TODOs, insights, and key points.
  • ๐Ÿ“ Raw Transcript Preservation: Raw transcripts are retained in collapsible <details><summary>๐Ÿ“ Raw Transcripts</summary></details> blocks.
  • ๐Ÿ“… Automated Daily Journaling: Appends entries cleanly to your existing daily notes and refreshes frontmatter updated: timestamps.
  • ๐Ÿ—“๏ธ Interactive Calendar & Date Range Batching: Batch process historical recordings for any selected days or date ranges.
  • ๐Ÿ”’ 100% Private & Local-First: Zero telemetry, zero tracking, no intermediate servers. All API keys and recordings remain strictly in your local vault.

๐Ÿš€ Recommended Provider: Groq + DeepSeek / OpenAI

For the fastest and most cost-effective experience:

Service Provider Recommended Model Benefits
Speech-to-Text (STT) Groq Cloud whisper-large-v3 / whisper-large-v3-turbo Near-instant transcription speed, generous free tier
Summarization (LLM) DeepSeek or OpenAI deepseek-chat / gpt-4o-mini High-quality reasoning, highly affordable, concise Markdown

๐Ÿ“ฆ Installation

Manual Installation

  1. Download the latest main.js, manifest.json, and styles.css from the Releases page.
  2. Create a folder in your vault: <vault>/.obsidian/plugins/vocalog/
  3. Copy the downloaded files into that folder.
  4. Open Obsidian โ†’ Settings โ†’ Community plugins โ†’ Enable Vocalog.

โš™๏ธ Configuration

Navigate to Settings โ†’ Vocalog:

1. Basic Configuration

  • Audio Folder: Folder where recordings are stored (e.g. attachments or Inbox/Voice). Defaults to Inbox/Voice.
  • Output Folder: Folder where daily notes are saved (leave empty for vault root).
  • Daily Note Format: Date pattern matching your daily notes (default: YYYY-MM-DD).

2. Speech-to-Text (STT) Settings

  • STT API URL:
    • Groq: https://api.groq.com/openai/v1/audio/transcriptions
    • OpenAI: https://api.openai.com/v1/audio/transcriptions
  • STT API Key: Your provider API key.
  • STT Model: whisper-large-v3 (Groq) or whisper-1 (OpenAI).

3. AI Summarization (LLM) Settings

  • LLM API URL:
    • DeepSeek: https://api.deepseek.com/v1/chat/completions
    • OpenAI: https://api.openai.com/v1/chat/completions
    • Groq: https://api.groq.com/openai/v1/chat/completions
    • Local (Ollama): http://localhost:11434/v1/chat/completions
  • LLM API Key: Your LLM API key.
  • LLM Model: deepseek-chat, gpt-4o, llama-3.3-70b-versatile, etc.
  • System Prompt: Customize how the AI formats your daily notes.

๐ŸŽฎ How to Use

1. Live Recording (Ribbon Icon)

  • Click the Vocalog Studio Mic icon in the left ribbon to start recording.
  • The icon pulses red while you speak.
  • Click the icon again to stop: Vocalog automatically transcribes, generates AI notes, and writes to your daily journal!

2. Command Palette

  • Vocalog: Start / stop live audio recording
  • Vocalog: Generate audio notes (processes today's audio files in the folder)
  • Vocalog: Generate audio notes by date range (opens interactive calendar modal)
  • Vocalog: Generate from selected audio files (processes files selected in File Explorer)

3. File Explorer Context Menu

  • Right-click any .mp3, .m4a, .wav, .webm, or .ogg file in Obsidian โ†’ select Generate audio note.

๐Ÿ”’ Privacy & Security

  • Direct Connections: Network requests are made directly from your Obsidian client to your configured API endpoints.
  • No Third-Party Middleman: There are no proxy servers, tracking scripts, or analytics.
  • Credential Storage: API keys are securely saved only in your local .obsidian/plugins/vocalog/data.json file.

๐Ÿค Contributing & Feedback

Contributions, feature requests, and bug reports are warmly welcome!

  • Open an Issue to report a bug or request a feature.
  • Submit a Pull Request following standard Git Flow (feature/... branches into develop).

๐Ÿ“„ License

Distributed under the MIT License.

About

๐ŸŽ™๏ธ Obsidian AI Voice Notes & Audio Journal: Live mic recording, Whisper STT (Groq/OpenAI), and LLM-powered structured daily notes with transcript preservation.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0