Skip to content

LunaAI519/xsub

Repository files navigation

xsub

English | 中文

开源 Chrome 扩展(Manifest V3):在 x.com 播放英文视频时,自动在视频上叠加中文字幕。

双语字幕效果

  • 有 CC 字幕轨 → 直接抓取(成本≈0)
  • 无 CC → 阿里云百炼语音识别,支持实时流式(几秒出首条字幕)与文件转写两种模式
  • 翻译走 DeepSeek 全文语境翻译,自有 API key,成本自控
  • 预算护栏:默认每日转写上限 ¥2,超限自动暂停、可手动放行

状态:v0.4.1,稳定可用(CC 抓取 / 文件转写 / 实时流式 / 预算护栏),欢迎 PR 和 issue。

5 分钟最简上手:只想看有 CC 字幕的英文视频?装好扩展后只需填一个 DeepSeek API Key 就能用,成本几分钱一条视频。百炼 Key 和 Worker 中继只有转写无 CC 视频才需要(进阶,见下方配置表)。

实测成本参考:有 CC 的视频几乎免费(只花翻译费,几分钱);无 CC 走语音转写,31 分钟约 ¥0.15,83 分钟约 ¥0.4;同视频二刷命中本地缓存,零成本。默认每日转写预算上限 ¥2,可配。

安装

前置要求:Chrome 111+。

方式 A:下载安装包(推荐)

  1. Releases 下载 xsub-vX.X.X.zip,解压
  2. 打开 chrome://extensions,右上角开「开发者模式」
  3. 「加载已解压的扩展程序」→ 选择解压出来的文件夹

方式 B:源码构建(需 Node.js 20.19+ 或 22.12+)

git clone https://github.com/LunaAI519/xsub.git
cd xsub
npm install && npm run build

然后按方式 A 的第 2、3 步加载 dist/ 目录。

配置

扩展详情页 → 「扩展程序选项」,共三项:

配置 用途 何时需要
DeepSeek API Key 字幕翻译 必填(platform.deepseek.com 注册取 Key)
百炼(DashScope)API Key 无 CC 视频的语音识别 视频没有 CC 字幕时需要(百炼控制台取 Key)
中继地址 + Secret Cloudflare Worker 音频中继 同上,配套部署,5 分钟指引见 worker/README.md

选项页

隐私声明

零遥测、零数据收集。音频与字幕文本只发往你自己配置的阿里云与 DeepSeek 账户,本项目不经手、不收集任何数据;密钥仅存于本机 chrome.storage.local

关于权限:manifest 里的 optional_host_permissions: ["https://*/*"] 仅用于访问你自己配置的中继域名(域名是用户自定义的,安装时无法预知),默认不激活,不配中继就不会申请。

免责声明

  • 非 X 官方项目,与 X Corp. 无任何关联。
  • 依赖非公开接口,X 改版后随时可能失效。
  • 使用者需自行确保符合所在地法律与平台服务条款。
  • 字幕为 AI 生成,仅供参考。仅供个人学习用途。

相关项目

  • video-to-brain — 发视频给 Telegram Bot,AI 自动生成结构化笔记进 Obsidian
  • motion-skill — Claude Code skill:一张参考图生成复古剪贴报风格动画
  • 更多作品见 imluna.ai

License

MIT © Luna (imluna.ai)

About

Chrome 扩展:给 x.com 英文视频自动叠加中文字幕(CC 抓取 / 语音转写 / 实时流式,自有 API key 成本自控)

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors