yt-short-clipper

环境要求

• 仅支持 Windows（构建脚本为 PowerShell，字幕/钩子渲染读取 C:\Windows\Fonts）
• 需要 WebView2 运行时（应用以 portable zip + WebView2 bootstrapper 形式分发）
• 需要 Node.js / npm（用于 React 19 + Vite + Tauri 前端依赖）
• 需要 Python，并能通过 Windows 的 py 启动器执行（用于 yt-dlp、FFmpeg、MediaPipe 侧车）
• 需要下载 FFmpeg 与 Deno 运行时二进制
• 需要一个 YouTube 的 cookies.txt

安装与启动步骤

1. 1确认系统环境

   官方明确仅支持 Windows：构建脚本是 PowerShell，字体从 C:\Windows\Fonts 读取，应用带 WebView2 引导程序；请先装好 Node.js、Python 与 WebView2。

2. 2获取项目源码

   把仓库克隆到本地，后续所有安装命令都在仓库根目录执行。

   git clone https://github.com/jipraks/yt-short-clipper.git

   复制

3. 3安装 Node 依赖

   在仓库根目录执行，安装 React/Vite/Tauri 桌面壳所需的前端依赖。

   npm install

   复制

4. 4安装 Python 依赖

   用 Windows 的 py 启动器安装 requirements.txt 中的 Python 侧依赖（yt-dlp、MediaPipe 等）。

   py -m pip install -r requirements.txt

   复制

5. 5下载运行时二进制

   README 的 Setup 第 3 步要求下载 FFmpeg、Deno 运行时二进制，但节选中未给出具体命令和存放路径，请以仓库最新说明为准。

6. 6准备 cookies.txt

   从浏览器导出 YouTube 的 cookies.txt，运行后在应用界面中上传；yt-dlp 依赖它抓取视频和原字幕轨。

7. 7启动应用

   README 节选未给出启动/运行命令，请按仓库完整文档启动 Tauri 应用，此处不虚构命令。

关键配置

如何确认成功

README 未给出启动命令与成功标志；能打开应用窗口、上传 cookies.txt 后成功抓取 YouTube 视频即视为可用。

常见问题

注意事项

• 项目目前为 beta 状态，版本之间可能有破坏性变更。
• 仅 Windows 可用，且依赖 WebView2 与 PowerShell 构建脚本。
• 竖屏重构提供人脸追踪（MediaPipe）、黑边居中、居中三种模式。
• 安装需从源码构建 Tauri 桌面应用，并额外下载 FFmpeg、Deno 二进制。