Obsidian 플러그인 문서
Obsidian용 SpeakNotes 플러그인 설치, 구성 및 사용에 대한 전체 가이드입니다.
설치
플러그인 다운로드
Obsidian용 SpeakNotes 플러그인의 최신 버전을 다운로드하세요.
플러그인 다운로드Obsidian에 설치
- Obsidian을 열고 설정 → 커뮤니티 플러그인으로 이동합니다
- 메시지가 표시되면 안전 모드를 비활성화합니다
- '파일에서 설치'를 클릭하거나 다운로드한 zip 파일을 보관소의 .obsidian/plugins/speaknotes 폴더에 압축을 풉니다
- 커뮤니티 플러그인 목록에서 SpeakNotes 플러그인을 활성화합니다
플러그인 활성화
설치 후 커뮤니티 플러그인 설정에서 플러그인을 활성화해야 합니다. 리본에 마이크 아이콘이 나타나는 것을 확인할 수 있습니다.
시작하기
SpeakNotes 계정 연결
- 설정 → SpeakNotes를 엽니다
- 'SpeakNotes로 로그인'을 클릭합니다
- 브라우저에서 SpeakNotes 계정으로 로그인합니다
- 플러그인이 자동으로 연결되고 동기화를 시작합니다
참고: 플러그인을 사용하려면 SpeakNotes 계정이 필요합니다. 계정이 없다면 speaknotes.io에서 가입하세요.
음성 메모 녹음
Obsidian에서 직접 음성 메모를 녹음하세요. 녹음 내용은 전사 및 요약을 위해 SpeakNotes에 자동으로 업로드됩니다.
녹음 방법
- 리본의 마이크 아이콘을 클릭하거나 'SpeakNotes: Record Voice Memo' 명령어를 사용하세요.
- '녹음 시작'을 클릭하고 마이크에 대고 말씀하세요.
- 완료되면 '녹음 중지'를 클릭하세요.
- 제목과 요약 형식을 선택한 다음 처리가 완료될 때까지 기다리세요.
녹음 기능
- 실시간 파형 시각화
- 녹음 타이머 표시
- 14개 이상의 요약 형식(노트, 글머리 기호, 회의록 등) 중에서 선택하세요.
라이브러리 동기화
Obsidian 보관함을 SpeakNotes 라이브러리와 동기화 상태로 유지하세요. 모든 전사 내용과 요약은 Markdown 파일로 내보낼 수 있습니다.
자동 동기화
설정에서 '자동 동기화'를 활성화하면 Obsidian이 시작될 때 자동으로 동기화됩니다. 또한 동기화 간격을 설정하여 하루 종일 라이브러리를 최신 상태로 유지할 수 있습니다.
수동 동기화
'SpeakNotes: Sync SpeakNotes Library' 명령어를 사용하거나 사이드바의 동기화 버튼을 클릭하여 언제든지 수동으로 동기화할 수 있습니다.
폴더 구조
동기화된 노트는 설정된 내보내기 폴더(기본값: 'SpeakNotes')에 저장됩니다. 플러그인은 Obsidian에서 SpeakNotes 폴더 구조를 유지합니다.
사용 가능한 명령어
명령 팔레트(Ctrl/Cmd + P)를 통해 모든 명령어에 액세스할 수 있습니다. 모든 명령어 앞에는 'SpeakNotes:'가 붙습니다.
SpeakNotes 라이브러리 사이드바를 열어 노트를 탐색하고 검색합니다.
새로운 음성 메모를 캡처하기 위해 녹음 모달을 엽니다.
SpeakNotes 라이브러리를 보관함과 수동으로 동기화합니다.
현재 열려 있는 노트를 SpeakNotes로 내보냅니다.
보관함의 여러 노트를 SpeakNotes로 한 번에 내보냅니다.
SpeakNotes의 노트를 보관함으로 가져옵니다.
SpeakNotes 노트를 스캔하고 보관함의 관련 콘텐츠에 대한 백링크를 생성합니다.
SpeakNotes 노트 간의 연결을 시각적 그래프로 봅니다.
설정 참조
연결 설정
- 연결된 계정 - 연결된 SpeakNotes 계정 이메일을 표시합니다. 연결을 해제하려면 '연결 해제'를 클릭하세요.
- 마지막 동기화 - 라이브러리가 마지막으로 동기화된 시간을 표시합니다. 수동 동기화를 시작하려면 '지금 동기화'를 클릭하세요.
동기화 설정
- 내보내기 폴더 - SpeakNotes 파일이 저장될 보관함 내의 폴더입니다. 기본값은 'SpeakNotes'입니다.
- 자동 동기화 - Obsidian이 시작될 때 라이브러리를 자동으로 동기화합니다.
- 동기화 간격 - 동기화 빈도(분 단위)입니다. 주기적 동기화를 비활성화하려면 0으로 설정하세요. 기본값은 30분입니다.
콘텐츠 설정
- 기본 요약 형식 - 새로운 녹음에 사용되는 기본 형식입니다(예: 노트, 글머리 기호, 회의록).
- 전체 전사 내용 포함 - 내보낸 노트에 전체 전사 텍스트를 포함할지 여부입니다.
- 내보내기 템플릿 - 내보낸 노트를 위한 사용자 정의 Markdown 템플릿입니다. 기본 템플릿을 사용하려면 비워 두세요.
내보내기 템플릿
SpeakNotes를 Obsidian으로 내보낼 때 형식을 사용자 정의합니다. 템플릿 변수를 사용하여 노트 데이터를 삽입하세요.
| 변수 | 설명 |
|---|---|
| {{id}} | 노트의 고유 SpeakNotes ID |
| {{title}} | 노트 제목 |
| {{created}} | 노트 생성 날짜 (ISO 형식) |
| {{updated}} | 노트 최종 수정 날짜 (ISO 형식) |
| {{type}} | 콘텐츠 유형 (audio, video, youtube, pdf) |
| {{status}} | 처리 상태 (Done, Processing, Error) |
| {{format}} | 요약 형식 (note, bullet-points, meeting-notes 등) |
| {{isPinned}} | 노트 고정 여부 (true/false) |
| {{summary}} | AI가 생성한 요약 내용 |
| {{transcription}} | 전체 전사 텍스트 (설정에서 활성화된 경우) |
예시 템플릿
---
speaknotes_id: {{id}}
created: {{created}}
updated: {{updated}}
type: {{type}}
tags: [speaknotes]
---
# {{title}}
## Summary
{{summary}}
## Transcription
{{transcription}}문제 해결
플러그인이 내 계정에 연결되지 않습니다
브라우저에서 SpeakNotes에 로그인되어 있는지 확인하세요. 플러그인 설정에서 연결을 해제했다가 다시 연결해 보세요. 브라우저에서 speaknotes.io의 팝업을 허용하는지 확인하세요.
노트가 동기화되지 않습니다
상태 표시줄을 확인하여 연결 상태를 확인하세요. 'Done' 상태인 노트만 동기화됩니다. 명령 팔레트를 사용하여 수동 동기화를 시도해 보세요. 내보내기 폴더가 존재하고 쓰기 가능한지 확인하세요.
녹음이 시작되지 않습니다
브라우저/Obsidian에 마이크 권한이 있는지 확인하세요. 다른 앱에서 마이크를 사용하고 있지 않은지 확인하세요. Obsidian을 다시 시작해 보세요.
동기화 후 일부 노트가 누락되었습니다
완료된 노트(상태: Done)만 동기화됩니다. 아직 처리 중인 노트는 완료된 후에 나타납니다. 사이드바의 폴더 필터를 확인하세요.
여전히 문제가 있나요? 다음으로 문의해 주세요: [email protected]