经 AI Skill Hub 精选评估，TubeSage 获评「推荐使用」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 7.5 分，适合有一定技术背景的用户使用。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
TubeSage 依赖 TypeScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 TypeScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 TubeSage 的版本更新，及时通知重要功能变化。
📋 工具概览
Obsidian插件，YouTube字幕LLM摘要
TubeSage 是一款基于 TypeScript 开发的开源工具，专注于 Obsidian、YouTube、LLM 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
Obsidian插件，YouTube字幕LLM摘要
TubeSage 是一款基于 TypeScript 开发的开源工具，专注于 Obsidian、YouTube、LLM 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：npm 全局安装 npm install -g tubesage # 方式二：npx 直接运行（无需安装） npx tubesage --help # 方式三：项目依赖安装 npm install tubesage # 方式四：从源码运行 git clone https://github.com/rmccorkl/TubeSage cd TubeSage npm install npm start
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
tubesage --help
# 基本用法
tubesage [options] <input>
# Node.js 代码中使用
const tubesage = require('tubesage');
const result = await tubesage.run(options);
console.log(result);
# tubesage 配置说明 # 查看配置选项 tubesage --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export TUBESAGE_CONFIG="/path/to/config.yml"
TubeSage
TubeSage is an Obsidian plugin that converts YouTube videos into structured notes using large language models. It extracts transcripts, generates summaries, and can add timestamped links back to specific moments in the video.
Demo — click the image to watch the walkthrough video:
Features
- Transcript extraction from YouTube videos with fallback methods
- Summary generation using a configurable LLM provider
- Optional timestamp links added to section headings, linking to the moment in the video
- Works on desktop and mobile Obsidian
- Batch processing of YouTube channels and playlists
- Multi-provider support: OpenAI, Anthropic, Google Gemini, OpenRouter, Ollama, and any OpenAI-compatible server
- A cross-platform fetch shim so all providers work on mobile without Node.js dependencies
- Live progress while a job runs — a status-bar spinner on desktop, a tappable notice on mobile
Requirements
- Obsidian v1.13.0+ (TubeSage uses the declarative settings API introduced in 1.13.0; it also stores cloud API keys using Obsidian's secret storage, available since 1.11.4)
- Templater plugin (required for template functionality)
- An API key for at least one LLM provider:
- OpenAI
- Anthropic
- Google (Gemini)
- OpenRouter
- Ollama (local models)
- An OpenAI-compatible server such as LM Studio, vLLM, llama.cpp server or LocalAI (key optional)
- A YouTube Data API key (optional — required only for channel/playlist processing)
Installation
Community Plugins: Install through Obsidian's Settings → Community plugins browser once TubeSage is listed in the directory.
Manual install from a GitHub release: 1. Open the latest release page. 2. From the Assets section, download main.js, manifest.json, and styles.css. Do not download "Source code (zip)" or "Source code (tar.gz)" — those are source archives and will not load as a plugin. 3. In your vault, create the folder .obsidian/plugins/tubesage/. 4. Move the three downloaded files into that tubesage/ folder. 5. In Obsidian, go to Settings → Community plugins, toggle off "Restricted mode" if needed, refresh the installed-plugins list, and enable TubeSage. 6. Accept the license terms in TubeSage's settings panel. 7. Configure API keys for your preferred LLM provider. 8. (For YouTube notes) Install the Templater plugin for template-driven formatting.
Recommended setup
For the most reliable results, use OpenRouter as the LLM provider together with ScrapeCreators for transcript retrieval. Direct YouTube transcript extraction breaks whenever YouTube changes or restricts how captions are served, so a paid transcript service is the dependable path. Gemini's lower-cost tiers are rate-limited and can be throttled or unavailable under load, whereas OpenRouter lets you pick a model with the capacity you need. Other providers still work; this is the combination the maintainer has found most dependable.
2. LLM provider setup
Choose a provider in settings. Only that provider's settings are shown — its key, model and address; the other providers' fields are hidden, not cleared, so switching back finds them as you left them.
- OpenAI — models such as GPT-4o, GPT-4, GPT-3.5-Turbo.
- Anthropic — Claude 3 family models.
- Google Gemini — Gemini Pro models.
- OpenRouter — gateway access to models from multiple vendors.
- Ollama — local open-source models; runs offline, requires Ollama installed and running. Ollama on another machine works too: put that machine's address in the Ollama field, for example
http://192.168.1.20:11434(Ollama itself must be listening on the network, e.g. started withOLLAMA_HOST=0.0.0.0). - OpenAI-compatible server — any self-hosted server that speaks the OpenAI chat API, such as LM Studio, vLLM, llama.cpp server or LocalAI. Enter its base URL, which usually ends in
/v1(for examplehttp://192.168.1.20:1234/v1; plainhttp://is accepted), and type the model name exactly as the server lists it. The API key is optional: leave it blank if the server does not check one.
Custom base URL for any provider: OpenAI, Anthropic, Google and OpenRouter can each be pointed at another address — a corporate proxy, a gateway such as LiteLLM, or a mirror. Turn on that provider's Custom base URL toggle to show its base URL field; turn it off to go back to the vendor's address while keeping what you typed. Leave the field blank to use the vendor's own address, which it shows as its placeholder. The shape differs by vendor, so copy the placeholder's: OpenAI and OpenRouter include the version (https://api.openai.com/v1), Anthropic and Google do not (https://api.anthropic.com). Chat requests and the model-list refresh both go to the address you set, and that provider's API key is sent to it. Only bearer-style keys are supported, so services that need another auth scheme (Azure OpenAI's api-key header, for example) are not.
Where API keys are stored: cloud-provider keys (OpenAI, Anthropic, Google, OpenRouter), the optional OpenAI-compatible server key and the transcript-service keys (YouTube Data API, ScrapeCreators, Supadata) are saved in Obsidian's native secret storage, not in the plugin's data.json. Type a key into its field and it is written to the secret store automatically — there is no separate setting to enable this, and it is not optional. The Ollama field, the OpenAI-compatible server URL and the custom base URLs hold server addresses rather than secrets, so they remain in plugin data.
Quick Start
Usage
Configuration
3. Other settings
- Summary modes: Fast (brief) or Extensive (detailed).
- Timestamp processing: enable or disable automatic timestamp links.
- Batch processing: sequential or parallel processing for collections.
- Performance monitoring: optional logging of processing times.
API keys
Cloud-provider API keys (OpenAI, Anthropic, Google, OpenRouter), the optional OpenAI-compatible server key and the transcript-service keys (YouTube Data API, ScrapeCreators, Supadata) are stored in Obsidian's native secret storage, never written to the plugin's data.json. Keys saved in data.json by older versions (before 1.3.0 for the cloud-provider keys) are migrated into secret storage automatically the first time you open the plugin after upgrading.
Basic workflow
- Click the YouTube icon in the ribbon, or use the Command Palette.
- Paste a YouTube video URL.
- Choose a summary mode and folder location.
- Run processing.
- The resulting note appears in the chosen folder.
Troubleshooting
- API key errors: verify keys are configured correctly in settings.
- Mobile processing issues: ensure a stable connection, or use Ollama for offline processing.
- Timestamp link failures: check video availability and URL format.
- Batch processing limits: monitor YouTube API quota usage.
TubeSage 是一款专为 Obsidian 设计的强大插件，能够利用大语言模型（LLM）将 YouTube 视频高效转化为结构化的笔记。它不仅可以自动提取视频字幕，还能生成智能摘要，并支持在笔记标题中自动添加带时间戳的链接，方便用户直接跳转回视频的具体时刻。无论是学习视频还是会议记录，TubeSage 都能帮你实现从视频到知识库的无缝转化。
TubeSage 提供了一��列强大的功能：支持从 YouTube 提取字幕（并具备备选方案），通过可配置的 LLM 提供商生成摘要；支持在章节标题中自动添加时间戳链接，实现视频回溯；完美适配 Obsidian 桌面端与移动端；支持对 YouTube 频道和播放列表进行批量处理。此外，它兼容 OpenAI、Anthropic、Google Gemini、OpenRouter 以及本地运行的 Ollama，满足多种使用场景。
在使用 TubeSage 之前，请确保您的环境满足以下要求：首先，Obsidian 版本需在 v1.11.4 或以上，以便利用其内置的 secret storage 安全存储云端 API keys；其次，必须安装 Templater 插件以实现模板功能；最后，您需要准备好相应的 LLM API key 或本地运行的 Ollama 环境，以驱动核心的摘要生成能力。
您可以通过两种方式安装 TubeSage：1. 社区插件安装：在 Obsidian 的 Settings → Community plugins 浏览器中搜索并安装 TubeSage 即可。2. 手动安装：访问 GitHub 的 latest release 页面，在 Assets 区域下载 `main.js`、`manifest.json` 和 `styles.css` 三个文件，并将其放入 Obsidian 的插件目录中。请注意，不要直接下载 "Source code (zip)" 作为插件包。
TubeSage 的使用流程非常直观。您只需点击 Obsidian 侧边栏的 YouTube 图标，或通过 Command Palette 调用相关命令，随后粘贴想要转换的 YouTube 视频 URL。接着，根据需求选择摘要模式（Fast 或 Extensive）以及存放笔记的目标文件夹，点击运行即可。处理完成后，生成的结构化笔记将自动出现在您指定的文件夹中。
在配置阶段，您可以根据需求选择不同的 LLM 提供商，包括 OpenAI (GPT 系列)、Anthropic (Claude 系列)、Google Gemini、OpenRouter 以及支持本地离线运行的 Ollama。插件还提供了丰富的自定义选项：您可以设置摘要模式（Fast 简略或 Extensive 详细）、开启或关闭时间戳链接处理、配置批量处理模式（顺序或并行），以及开启性能监控日志以观察处理耗时。
TubeSage 在安全性方面做了深度优化。对于 OpenAI、Anthropic、Google 和 OpenRouter 等云端提供商的 API keys，插件会将其存储在 Obsidian 原生的 secret storage 中，而不会明文写入 `data.json` 配置文件中。如果您是从 1.3.0 之前的旧版本升级，插件会在首次运行时自动将旧版密钥迁移至安全的 secret storage 中。
TubeSage 的核心工作流设计简洁高效：用户通过侧边栏图标或命令面板启动插件 $\rightarrow$ 输入 YouTube 视频链接 $\rightarrow$ 选择摘要详细程度及输出路径 $\rightarrow$ 执行自动化处理 $\rightarrow$ 最终在 Obsidian 库中获得一份包含时间戳跳转功能的结构化笔记。
在使用过程中如遇到问题，可以参考以下排查建议：若遇到 API key 错误，请检查设置中的密钥配置是否��确；移动端处理失败通常与网络连接有关，建议检查网络稳定性或改用 Ollama 进行离线处理；若时间戳链接失效，请确认视频是否可用及 URL 格式是否正确；在进行批量处理时，请务必关注 YouTube API 的配额限制，以防处理中断。
自动化YouTube字幕摘要，提高效率
- 需要 TubeSage 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 需要 TubeSage 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：TubeSage 的核心功能完整，质量良好。对于AI 技术爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | TubeSage |
| 原始描述 | 开源AI工具：An Obsidian Plugin for Youtube Transcript LLM Summary。⭐6 · TypeScript |
| Topics | ObsidianYouTubeLLM |
| GitHub | https://github.com/rmccorkl/TubeSage |
| License | MIT |
| 语言 | TypeScript |
收录时间：2026-05-17 · 更新时间：2026-05-30 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。