Voicenotes Integration
Sync voice notes from voicenotes.com into the workspace.
Setup
- 1. Get access token from: https://voicenotes.com/app?obsidian=true#settings
- Set environment variable: INLINECODE0
Quick Start
CODEBLOCK0
Scripts
fetch-notes.sh
Fetch voice notes as JSON.
CODEBLOCK1
get-user.sh
Verify token and get user info.
CODEBLOCK2
sync-to-markdown.sh
Sync notes to markdown files with frontmatter.
CODEBLOCK3
Output format:
CODEBLOCK4
API Reference
Base URL: INLINECODE1
Headers required:
Endpoints:
- -
GET /user/info - User details - INLINECODE5 - List voice notes (paginated)
- INLINECODE6 - Audio download URL
Data Structure
Each voice note contains:
- -
recording_id - Unique identifier - INLINECODE8 - Note title
- INLINECODE9 - Full transcript text
- INLINECODE10 - AI summaries, action items, etc.
- INLINECODE11 - User tags
- INLINECODE12 /
updated_at - Timestamps - INLINECODE14 - Recording length in seconds
Tips
- - Notes are paginated; check
links.next for more pages - Use
--since to fetch only new notes since last sync - AI creations include summaries, todos, and custom prompts
- Rate limited to ~60 requests/minute
Voicenotes 集成
将 voicenotes.com 的语音笔记同步到工作区。
设置
- 1. 从以下地址获取访问令牌：https://voicenotes.com/app?obsidian=true#settings
- 设置环境变量：export VOICENOTES_TOKEN=your-token-here
快速开始
bash
验证连接
./scripts/get-user.sh | jq .
获取最近的笔记（JSON格式）
./scripts/fetch-notes.sh | jq .data[:3]
将所有笔记同步为Markdown文件
./scripts/sync-to-markdown.sh --output-dir ./voicenotes
脚本
fetch-notes.sh
以JSON格式获取语音笔记。
bash
./scripts/fetch-notes.sh # 所有笔记
./scripts/fetch-notes.sh --limit 10 # 最近10条笔记
./scripts/fetch-notes.sh --since 2024-01-01 # 自指定日期以来的笔记
get-user.sh
验证令牌并获取用户信息。
bash
./scripts/get-user.sh | jq {name, email}
sync-to-markdown.sh
将笔记同步为带有前置元数据的Markdown文件。
bash
./scripts/sync-to-markdown.sh --output-dir ./voicenotes
输出格式：
markdown
voicenotes_id: abc123
created: 2024-01-15T10:30:00Z
tags: [idea, project]
笔记标题
转录内容
转录的文本内容...
摘要
AI生成的摘要...
API 参考
基础URL：https://api.voicenotes.com/api/integrations/obsidian-sync
必需请求头：
- - Authorization: Bearer {token}
- X-API-KEY: {token}
接口端点：
- - GET /user/info - 用户详情
- GET /recordings - 列出语音笔记（分页）
- GET /recordings/{id}/signed-url - 音频下载链接
数据结构
每条语音笔记包含：
- - recordingid - 唯一标识符
- title - 笔记标题
- transcript - 完整转录文本
- creations[] - AI摘要、待办事项等
- tags[] - 用户标签
- createdat / updated_at - 时间戳
- duration - 录音时长（秒）
提示
- - 笔记采用分页方式；查看 links.next 获取更多页面
- 使用 --since 仅获取上次同步后的新笔记
- AI生成内容包括摘要、待办事项和自定义提示
- 速率限制约为每分钟60次请求
