배움의 달인 Newsletter

Insight Hub

Back to Home

Voice Writing 플러그인 완벽 가이드

2025-12-17
16 min read
3041 words

Voice Writing 플러그인 완벽 가이드 - 음성으로 옵시디언 노트 작성하기

키보드 없이도 생각을 바로 노트로! 음성 녹음과 AI 전사 기능을 활용한 옵시디언 글쓰기

이 플러그인은 뭔가요?

Voice Writing은 옵시디언에서 음성을 텍스트로 변환해주는 플러그인입니다.

  • 마이크 버튼 하나로 녹음 시작
  • AI가 자동으로 음성을 텍스트로 변환
  • 회의록, 강의노트 등 템플릿으로 자동 정리까지!
flowchart LR
    A[🎤 음성 녹음] --> B[☁️ AI 전사]
    B --> C[📝 텍스트 변환]
    C --> D[✨ 템플릿 정리]
    D --> E[📄 노트에 삽입]

    style A fill:#e1f5fe
    style B fill:#fff3e0
    style C fill:#e8f5e9
    style D fill:#fce4ec
    style E fill:#f3e5f5

시작하기 전에 준비할 것

API 키가 필요해요!

이 플러그인은 OpenAI 또는 Groq의 AI 서비스를 사용합니다.

API 키는 AI 서비스를 이용하기 위한 일종의 "이용권"이에요.

flowchart TD
    subgraph 추천["🌟 추천: Groq (무료!)"]
        G1[Groq 콘솔 접속] --> G2[회원가입/로그인]
        G2 --> G3[API Keys 메뉴]
        G3 --> G4[Create API Key 클릭]
        G4 --> G5[키 복사해서 보관]
    end

    subgraph 대안["💰 대안: OpenAI (유료)"]
        O1[OpenAI 플랫폼 접속] --> O2[회원가입/로그인]
        O2 --> O3[API Keys 메뉴]
        O3 --> O4[Create new key 클릭]
        O4 --> O5[키 복사해서 보관]
    end

    style 추천 fill:#e8f5e9
    style 대안 fill:#fff3e0

Groq API 키 발급 (무료, 추천!)

  1. console.groq.com/keys 접속

  2. 구글/깃허브 계정으로 간편 로그인

  3. Create API Key 버튼 클릭

  4. 생성된 키를 복사해서 안전한 곳에 저장

💡 Groq를 추천하는 이유: 현재 무료이면서도 속도가 매우 빠릅니다!

OpenAI API 키 발급 (유료)

  1. platform.openai.com/api-keys 접속

  2. 계정 생성 또는 로그인

  3. Create new secret key 클릭

  4. 생성된 키를 복사해서 안전한 곳에 저장

⚠️ 주의: OpenAI는 사용량에 따라 비용이 발생합니다 (약 시간당 $0.02)

플러그인 설치하기

방법 1: BRAT으로 설치 (베타 버전용)

  1. BRAT 플러그인 먼저 설치

    • 설정 → 커뮤니티 플러그인 → BRAT 검색 → 설치

  2. BRAT 설정 열기

  3. Add Beta plugin 클릭

  4. 저장소 주소 입력: reallygood83/voice-writing

  5. 설치 완료!

방법 2: 수동 설치

  1. GitHub Releases 페이지 방문

  2. 최신 버전의 main.js, manifest.json, styles.css 다운로드

  3. 옵시디언 볼트의 .obsidian/plugins/voice-writing 폴더에 파일 복사

  4. 옵시디언 재시작 후 플러그인 활성화

초기 설정하기

플러그인 설치 후, 반드시 설정을 완료해야 사용할 수 있어요!

flowchart TD
    A[⚙️ 설정 열기] --> B{어떤 서비스?}
    B -->|무료 원해요| C[Groq 선택]
    B -->|고품질 원해요| D[OpenAI 선택]
    C --> E[Groq API 키 입력]
    D --> F[OpenAI API 키 입력]
    E --> G[🧪 Test 버튼으로 확인]
    F --> G
    G --> H{테스트 성공?}
    H -->|Yes| I[✅ 설정 완료!]
    H -->|No| J[키 다시 확인]
    J --> E

    style I fill:#c8e6c9
    style J fill:#ffcdd2

단계별 설정

  1. 설정 → Voice Writing 메뉴 열기

  2. 서비스 선택

    • Groq 선택 (무료, 빠름) 또는
    • OpenAI 선택 (유료, 고품질)

  3. API 키 입력

    • 선택한 서비스의 API 키를 붙여넣기
    • Test 버튼을 눌러서 정상 작동 확인
    • "API key is valid!" 메시지가 나오면 성공!

  4. 언어 설정 (선택사항)

    • Auto Detect: 자동 감지 (기본값)
    • Korean: 한국어 전용
    • English: 영어 전용

사용법 1: 실시간 녹음하기

가장 기본적인 사용법! 마이크로 말하면 바로 텍스트로 변환됩니다.

sequenceDiagram
    participant U as 👤 사용자
    participant P as 🔌 플러그인
    participant AI as 🤖 AI 서비스
    participant N as 📄 노트

    U->>P: 🎤 마이크 아이콘 클릭
    P->>P: 녹음 시작 (빨간 점멸)
    U->>P: 🗣️ 말하기
    U->>P: 🎤 다시 클릭 (녹음 종료)
    P->>AI: 음성 파일 전송
    AI->>P: 텍스트 반환
    P->>U: 📋 템플릿 선택 창
    U->>P: 템플릿 선택
    P->>N: ✅ 노트에 텍스트 삽입

사용 순서

  1. 녹음 시작: 왼쪽 리본의 🎤 아이콘 클릭

    • 상태바에 "Recording..." 표시
    • 아이콘이 빨간색으로 깜빡임

  2. 말하기: 마이크에 대고 내용을 말해주세요

  3. 녹음 종료: 🎤 아이콘 다시 클릭

  4. 템플릿 선택: 팝업에서 원하는 형식 선택

    • 없음: 그대로 삽입
    • 회의록: 회의 형식으로 정리
    • 강의노트: 학습 내용 정리
    • 아이디어: 브레인스토밍 정리
    • 인터뷰: Q&A 형식 정리

  5. 완료: 현재 노트에 텍스트가 삽입됩니다!

사용법 2: 오디오 파일 업로드

이미 녹음된 파일이 있다면? 업로드해서 바로 전사할 수 있어요!

지원 파일 형식

  • MP3, WAV, M4A, WebM, OGG, FLAC

사용 순서

  1. 명령어 팔레트 열기: Cmd/Ctrl + P

  2. 명령어 검색: "Voice Writing: Upload Audio File" 입력

  3. 파일 선택: 전사할 오디오 파일 선택

  4. 템플릿 선택: 원하는 정리 형식 선택

  5. 완료: 전사된 텍스트가 노트에 삽입!

flowchart LR
    A[📁 오디오 파일] --> B[업로드]
    B --> C[AI 전사]
    C --> D[템플릿 선택]
    D --> E[📝 노트에 삽입]

    style A fill:#e3f2fd
    style E fill:#e8f5e9

사용법 3: 템플릿 활용하기

전사된 텍스트를 자동으로 깔끔하게 정리해주는 기능이에요!

제공되는 템플릿

템플릿 용도 특징
없음 원본 그대로 수정 없이 전사 텍스트만
회의록 회의, 미팅 참석자, 안건, 결정사항, Action Items
강의노트 수업, 강연 핵심 개념, 요약, 질문사항
아이디어 브레인스토밍 아이디어 목록, 장단점, 우선순위
인터뷰 면접, 대담 Q&A 형식, 핵심 인사이트

템플릿 작동 원리

flowchart TD
    A[원본 전사 텍스트] --> B{템플릿 선택}
    B -->|회의록| C[📋 회의 형식으로 정리]
    B -->|강의노트| D[📚 학습 형식으로 정리]
    B -->|아이디어| E[💡 아이디어 형식으로 정리]
    B -->|인터뷰| F[🎤 Q&A 형식으로 정리]
    B -->|없음| G[원본 그대로]

    C --> H[AI가 내용 분석 및 구조화]
    D --> H
    E --> H
    F --> H

    H --> I[📄 정리된 노트]
    G --> I

    style A fill:#fff3e0
    style I fill:#e8f5e9

고급 설정: 오디오 파일 저장하기

기본적으로 플러그인은 텍스트만 저장합니다.

녹음 파일도 함께 보관하고 싶다면 설정을 변경해주세요!

설정 방법

  1. 설정 → Voice Writing → Storage 섹션

  2. Save Audio Recordings: 토글을 ON으로 변경

  3. Audio Save Folder: 저장할 폴더 지정

    • 비워두면: 볼트 최상위에 저장
    • 예시: Recordings 또는 Assets/Audio
flowchart TD
    subgraph 기본["기본 설정 (저장 OFF)"]
        A1[🎤 녹음] --> A2[AI 전사]
        A2 --> A3[📝 텍스트만 노트에 삽입]
    end

    subgraph 저장["저장 ON 설정"]
        B1[🎤 녹음] --> B2[💾 오디오 파일 저장]
        B2 --> B3[AI 전사]
        B3 --> B4["📝 텍스트 + 🔗오디오 링크 삽입"]
    end

    style 기본 fill:#e3f2fd
    style 저장 fill:#e8f5e9

언제 저장 기능을 켜면 좋을까요?

  • ✅ 원본 녹음을 보관하고 싶을 때

  • ✅ 나중에 다시 들어볼 필요가 있을 때

  • ✅ 전사 품질을 확인하고 싶을 때

  • ❌ 저장 공간이 부족할 때

  • ❌ 텍스트만 필요할 때

빠른 설정 변경: Quick Options

설정 창을 열지 않고도 빠르게 옵션을 바꿀 수 있어요!

사용 방법

  1. Cmd/Ctrl + P 로 명령어 팔레트 열기

  2. "Voice Writing: Quick Options" 검색 및 실행

  3. 원하는 옵션 빠르게 변경

    • 서비스 변경 (OpenAI ↔ Groq)
    • 언어 변경

문제 해결 가이드

"API Key is missing" 오류

flowchart TD
    A[오류 발생] --> B{API 키 입력했나요?}
    B -->|No| C[설정에서 API 키 입력]
    B -->|Yes| D{올바른 서비스 선택?}
    D -->|No| E[서비스 변경 후 해당 키 입력]
    D -->|Yes| F[Test 버튼으로 키 유효성 확인]
    F --> G{테스트 성공?}
    G -->|No| H[새 API 키 발급]
    G -->|Yes| I[✅ 문제 해결!]

    style I fill:#c8e6c9

해결 방법:

  1. 설정 → Voice Writing 열기

  2. 사용할 서비스 확인 (OpenAI or Groq)

  3. 해당 API 키 입력

  4. Test 버튼으로 확인

"Transcription failed" 오류

가능한 원인:

  • 인터넷 연결 문제
  • API 키 만료 또는 할당량 초과
  • 오디오 파일이 25MB 초과

해결 방법:

  1. 인터넷 연결 확인

  2. API 키 유효성 테스트

  3. 긴 녹음은 나눠서 진행

마이크가 작동하지 않아요

확인 사항:

  1. 브라우저/앱에 마이크 권한 허용되어 있는지

  2. 시스템 설정에서 마이크가 활성화되어 있는지

  3. 다른 앱이 마이크를 사용 중인지

단축키 & 명령어 모음

명령어 설명
🎤 리본 아이콘 클릭 녹음 시작/중지
Voice Writing: Start Recording 녹음 시작
Voice Writing: Stop Recording 녹음 중지 및 전사
Voice Writing: Upload Audio File 오디오 파일 업로드
Voice Writing: Quick Options 빠른 설정 변경

마치며

Voice Writing 플러그인을 사용하면:

  • ⏱️ 시간 절약: 타이핑보다 말하기가 빠릅니다
  • 💡 아이디어 포착: 생각나는 즉시 녹음하세요
  • 📝 자동 정리: 템플릿으로 깔끔하게 구조화
  • 🔒 프라이버시: 여러분의 API 키로 직접 연결

이제 키보드에서 손을 떼고, 목소리로 노트를 작성해보세요! 🎉

관련 링크

이 가이드가 도움이 되셨다면, GitHub에서 ⭐ 스타를 눌러주세요!


---

tags:
  - 옵시디언
  - 플러그인
  - 음성인식
  - AI
  - Voice-Writing
created: 2024-12-17

category: 튜토리얼

---

🎓 더 많은 학습 자료와 소통

📺 배움의 달인 유튜브

💬 교육자 오픈채팅방

  • AI 활용 및 교육 현장 경험 공유 질의응답

🧠 Connected Insights

📅 Last analyzed: 2025. 12. 20. 오전 7:39:44
💰 Analysis cost: $0.0187

🔗 Related Notes

  • 🔗 Easy Gate 사용자 매뉴얼

    • related: 둘 다 옵시디언 플러그인 설치(브랫/수동), AI API 키 설정, 사용법 가이드를 다루며 개념적 연관성 높음. Easy Gate의 AI 분석 기능이 Voice Writing의 AI 전사와 논리적으로 지지됨.
    • Confidence: ████░ (75%)

  • ✅ Drive_Embedder_플러그인_완벽_가이드

    • supports: Voice Writing의 오디오 파일 업로드 및 미디어 처리 기능이 Drive Embedder의 구글 드라이브 미디어 임베드와 확장/지지 관계. 옵시디언 내 미디어 워크플로우 연결.
    • Confidence: ████░ (71%)

  • 🔗 RSS_Dashboard_플러그인_설치_가이드

    • related: 옵시디언 플러그인 설치 및 콘텐츠 관리 가이드 시리즈로 개념적 연관성. RSS의 콘텐츠 수집이 Voice Writing의 강의노트/회의록 템플릿과 유사한 입력 처리 패턴 공유.
    • Confidence: ████░ (70%)

📚 Knowledge Gaps

  • 🔴 템플릿 커스터마이징 방법

    • 기본 템플릿(회의록, 강의노트 등)만 언급되었으나 사용자 정의 템플릿 생성/편집 방법이 없어 고급 사용자에게 지식 갭 발생. 노트 작성 유연성 향상을 위해 필수.
    • Suggested resources: 플러그인 GitHub: https://github.com/reallygood83/voice-writing, Obsidian 포럼 플러그인 섹션

  • 🔴 문제 해결 및 트러블슈팅

    • API 테스트 실패나 녹음 오류 시 대처법이 부족. 설치/사용 가이드가 상세하나 실전 오류 대응이 미흡해 사용자 경험 저하 가능.
    • Suggested resources: GitHub Issues 페이지, Obsidian Discord 채널 #plugins

  • 🟡 프라이버시 및 보안 고려사항

    • 음성 데이터가 외부 AI(Groq/OpenAI)로 전송되나 데이터 처리/저장 정책 설명 없음. AI 통합 플러그인에서 중요한 윤리적/법적 갭.
    • Suggested resources: Groq/OpenAI 프라이버시 정책 문서, Obsidian 플러그인 보안 가이드라인

  • 🟡 다른 옵시디언 플러그인과의 통합

    • Easy Gate, Drive Embedder 등과의 워크플로우 연계 예시 없음. 음성 노트 생성 후 자동 클리핑/임베드 흐름이 지식 갭.
    • Suggested resources: Obsidian 플러그인 생태계 문서, 유저 워크플로우 공유 노트

💡 AI Insights

이 노트는 옵시디언 AI 통합 플러그인 가이드의 전형으로, 초보자 친화적 설치/사용 흐름(Mermaid 다이어그램 활용)이 강점. 다른 플러그인 가이드와 시리즈화되어 PKM(개인 지식 관리) 워크플로우를 강화하나, 고급 기능과 오류 대응이 부족해 완성도 향상 필요. 음성 입력 혁신으로 모바일/접근성 중심 사용자에게 특히 유용.

🧠 Connected Insights

📅 Last analyzed: 2025. 12. 21. 오후 7:31:40
💰 Analysis cost: $0.0235

🔗 Related Notes

  • 🔗 브라이언님의 css snippets 따라하기 - CMDS 노트, 템플릿 모음

    • related: Voice Writing 플러그인은 템플릿을 활용해 음성 전사를 정리하며, 대상 노트는 Obsidian CSS snippets와 템플릿 모음을 다루므로 개념적 연관성(템플릿 커스터마이징)이 높음. 템플릿 관련 지식 확장에 유용.
    • Confidence: ███░░ (67%)

  • ✅ Obsidian_AI_Dashboard_Proposal

    • supports: Voice Writing은 OpenAI/Groq AI를 활용한 Obsidian 플러그인으로, 대상 노트는 Obsidian AI 대시보드 플러그인 제안서. AI 통합 플러그인 생태계에서 논리적 지지 관계(AI 플러그인 확장 사례).
    • Confidence: ███░░ (66%)

  • 🔗 Obsidian_AI_Agent_Introduction

    • related: 둘 다 Obsidian AI 플러그인(음성 전사 vs AI 에이전트)을 다루며, API 의존성과 플러그인 설치/설정 공통점으로 개념적 연관성. AI 에이전트가 Voice Writing의 확장 가능성 예시.
    • Confidence: ███░░ (63%)

  • 🔗 호텔 바우처 발송 안내_ - 빈펄 리조트 & 스파 푸꾸옥 - 2026-01-07 ~ 2026-01-10 - 9078324710485 - jpmjkim23@gmail.com

    • related: 약한 연결: Voice Writing gaps에 프라이버시/보안이 있으며, 대상 노트는 이메일 공유(개인정보 포함)로 보안 고려사항 예시. 그러나 주제(여행 바우처)가 무관해 낮은 confidence.
    • Confidence: ███░░ (62%)

  • 🔗 소프트웨어의 미래 우리는 무엇을 만들어야할까?

    • related: Voice Writing은 AI 기반 소프트웨어 도구로, 대상 노트는 소프트웨어 미래 논의(AI 에이전트 등). AI 도구 개발 트렌드에서 간접적 연관성, Groq/OpenAI 같은 API 활용 사례로 확장 가능.
    • Confidence: ███░░ (60%)

  • 🔗 Easy Gate 사용자 매뉴얼

    • related: 기존 osba related: Obsidian 플러그인 매뉴얼로, 설치/설정 가이드 공통. Voice Writing 가이드 확장.
    • Confidence: ████░ (75%)

  • ✅ Drive_Embedder_플러그인_완벽_가이드

    • supports: 기존 osba supports: 다른 Obsidian 플러그인 가이드로, 통합/문제 해결 지식 지지.
    • Confidence: ████░ (71%)

  • 🔗 RSS_Dashboard_플러그인_설치_가이드

    • related: 기존 osba related: Obsidian 플러그인 설치 가이드 공통 패턴.
    • Confidence: ████░ (70%)

📚 Knowledge Gaps

  • 🔴 템플릿 커스터마이징 방법

    • 플러그인이 템플릿 선택을 강조하나 구체적 편집/커스텀 방법 미상세. CSS snippets 노트와 연계해 사용자 맞춤 템플릿 개발 필요.
    • Suggested resources: GitHub Voice Writing repo (reallygood83/voice-writing) 템플릿 예제, Obsidian Templater 플러그인 문서

  • 🔴 문제 해결 및 트러블슈팅

    • API 테스트만 언급, 녹음 실패/오전사 오류 등 실전 이슈 미포함. 사용자 경험 향상을 위해 필수.
    • Suggested resources: GitHub Issues 페이지, Obsidian Forum Voice Writing 스레드

  • 🟡 프라이버시 및 보안 고려사항

    • API 키 입력과 클라우드 전사로 데이터 유출 위험 있음. 로컬 처리 옵션이나 암호화 미언급.
    • Suggested resources: Groq/OpenAI Privacy Policy, Obsidian Local-First 플러그인 (e.g., Whisper.cpp)

  • 🟡 다른 옵시디언 플러그인과의 통합

    • AI Dashboard/Agent 노트와 연계 가능하나, Templater, Advanced Tables 등과의 워크플로 미상세.
    • Suggested resources: Obsidian Plugin Ecosystem 문서, Community Plugins Integration 가이드

  • 🟡 성능 벤치마크 및 비용 최적화

    • Groq 무료 강조하나 장기 사용량/속도 비교 없음. AI Agent 노트 gaps와 연동.
    • Suggested resources: Groq vs OpenAI Benchmark (Hugging Face), Obsidian AI 비용 추적 플러그인

💡 AI Insights

이 노트는 Obsidian Voice Writing 플러그인의 포괄적 가이드로 설치/설정/사용을 Mermaid 다이어그램으로 시각화해 초보자 친화적. AI 음성 전사 워크플로를 강조하나, gaps(커스터마이징, 트러블슈팅)가 사용자 채택 장벽. AI 플러그인 생태계(Drive Embedder, RSS Dashboard, AI Agent)와 연결되어 Second Brain 강화 도구로 확장 가능. 추가 노트로 플러그인 통합 네트워크 구축 추천.

Back to All Posts
NEW

뉴스레터 서비스가 정식 시작되었습니다!

매주 금요일, 옵시디언으로 정리한 AI 인사이트를 메일함으로 배달해 드립니다.