OmniGet Claude Code 插件安装与配置指南从 yt-dlp 到私有站点下载的完整部署方案【免费下载链接】omnigetDownload Udemy and Hotmart courses, YouTube videos, music and books — 1,800 sites, no terminal. Free open-source desktop app for Windows, macOS and Linux, with a built-in course player, PDF/EPUB reader and music library. Powered by yt-dlp. Your files stay on your computer.项目地址: https://gitcode.com/GitHub_Trending/om/omniget本指南以 claude-plugin/omniget/INSTALL.md 为主体讲解如何在 Claude Code 中安装并配置 OmniGet 插件通过一条命令完成yt-dlp/ffmpeg等工具的自动部署、可选的本机 Whisper 转写环境与云端转写密钥并掌握针对 Instagram/X 等登录门槛内容与限流问题的处理策略。读完本文你将能够在终端或 Claude Code 会话中完整搭建粘贴 URL → 下载媒体 字幕 转写文本的工作链路。插件是什么复用 OmniGet 能力的下载与转写工具链OmniGet 的 Claude Code 插件claude-plugin/omniget是一个面向媒体下载、字幕抓取与语音转写的工具集把一段视频、音频或社交帖子 URL 粘贴给 Claude Code就能拿到媒体文件、平台自带字幕以及一份可继续用于总结、引用或调研的转写稿。插件本身不重复造轮子而是复用 OmniGet 已安装的一切。其工具查找顺序由 resolve-tools.sh 实现与桌面端自身的解析器一致为显式覆盖OMNIGET_TOOL_NAME环境变量指定的二进制路径来源标记为customOmniGet 托管的目录桌面应用数据目录下的data dir/bin来源标记为omniget技能缓存插件自装的~/.cache/omniget-skill/bin来源标记为skill系统 PATH常规安装位置来源标记为system。这意味着插件不依赖桌面应用——只要yt-dlp与ffmpeg在 PATH 上它就能独立工作而如果桌面端已安装这两个二进制由应用管理安装脚本会自动找到它们而无需重复安装。依赖清单按需取用不必全装用途工具是否必需下载 / 元数据 / 字幕yt-dlpffmpeg必需可靠的 Instagram / X / Bilibili / Threads 抓取omniget-cli预编译二进制推荐本地离线转写whisper-cliwhisper.cpp或mlx_whisper 模型可选云端转写OpenAI或Gemini API 密钥可选这些依赖不需要全部满足只想要字幕仅需yt-dlpffmpeg转写能力任选其一即可平台字幕免费、本地 Whisper 模型离线免费、或一个云端密钥更准、免下载模型。第 1 步安装插件在 Claude Code 会话内/plugin marketplace add /path/to/omniget/claude-plugin /plugin install omniget两步即可完成插件注册与安装。安装完成后插件会提供五个斜杠命令详见各命令定义如 setup.md、fetch.md命令作用/omniget:fetch url [--audio] [--quality N]下载媒体到~/Downloads/omniget/omniget:transcribe url\|file [--backend B] [--lang xx] [--summarize]转写并可选择生成摘要/omniget:research url [--backend B]将字幕与转写提炼为带[mm:ss]时间戳引用的 Markdown 笔记/omniget:setup安装缺失工具 omniget-cli一次确认检查 API 密钥--update可刷新/omniget:doctor报告可用工具、模型与密钥以及补齐缺失项的方法此外omniget-fetch与omniget-transcribe两个技能skills 目录下会在粘贴媒体 URL 并提出请求时自动触发因此斜杠命令并非必须。第 2 步一键安装工具在 Claude Code 会话中运行/omniget:setup该命令内部执行 setup.sh可通过bash claude-plugin/omniget/scripts/setup.sh --yes从终端直接运行。脚本会自动检测操作系统og_os识别 mac/linux/windows并完成安装缺失的yt-dlp与ffmpeg一次确认后执行--yes跳过确认下载当前 OS/架构的预编译omniget-cli——它携带 OmniGet 原生的 Instagram/X/Bilibili/Threads 提取器对这些站点比裸yt-dlp更可靠报告哪些 API 密钥可用、如何添加一个。setup.sh 的 Flags 一览参数作用--yes/-y跳过确认提示直接安装--local额外搭建本机 Whisper 引擎 默认模型--no-cli跳过omniget-cli下载--update刷新yt-dlp与omniget-cli等价于--yes--check-only只报告状态并退出不安装任何东西对 Claude 安全从源码看setup.sh--update分支会按包管理器执行升级如brew upgrade yt-dlp ffmpeg、winget upgrade --silent yt-dlp.yt-dlp、pipx upgrade yt-dlp随后重新下载最新omniget-cli并调用keys.sh check复检密钥状态。安装命令则由install_cmd按工具:包管理器组合生成setup.sh下面逐一给出各平台实际执行的命令。各平台安装细节macOS—— 需要 Homebrew。安装yt-dlp、ffmpeg--local时还有whisper-cppbrew install yt-dlp brew install ffmpeg brew install whisper-cpp # 仅 --localomniget-cli会按 CPU 架构下载对应资产Apple Siliconaarch64-apple-darwin或 Intelx86_64-apple-darwin均为 tar.gz。脚本还会对下载的二进制执行xattr -d com.apple.quarantine移除隔离标记setup.sh。若 Homebrew 未安装脚本会提示先安装 Homebrew 再重跑。Windows—— 需要 wingetMicrosoft Store 的 App Installer或 scoopwinget install --silent --accept-package-agreements --accept-source-agreements yt-dlp.yt-dlp winget install --silent --accept-package-agreements --accept-source-agreements Gyan.FFmpegomniget-cli下载 x64 版本x86_64-pc-windows-msvczip 格式。对于本地 Whisper官方建议优先使用云端密钥——winget 未提供自动的 whisper-cpp 配方需手动安装。Linux—— 脚本自动检测apt-get/dnf/pacman/zypper# apt 系注意用 pipx 安装 yt-dlp 以保持最新 sudo apt-get update sudo apt-get install -y pipx pipx install yt-dlp sudo apt-get install -y ffmpeg # dnf 系 sudo dnf install -y yt-dlp ffmpeg # pacman 系 sudo pacman -S --noconfirm yt-dlp ffmpeg # zypper 系 sudo zypper install -y yt-dlp ffmpegsudo命令需要真实终端若在无 TTY 的环境如 Claude 会话运行脚本会检测到sudo且非交互输入打印出命令让用户自己执行setup.sh。omniget-cli仅提供 x86_64x86_64-unknown-linux-gnu预编译包没有 arm64 预编译——arm64 机器将退化为对所有站点使用yt-dlp。发行版的yt-dlp往往滞后而pipx install yt-dlpapt 系脚本采用的方案能始终保持在最新版。无包管理器时的降级路径若检测不到支持的包管理器脚本不会失败退出而是按平台打印指引setup.shmacOS先安装 Homebrew 再重跑Windows先安装 winget 或 scoop 再重跑Linux用发行版自带方式安装yt-dlp和ffmpeg后重跑。与桌面应用共存如果 OmniGet桌面应用已安装yt-dlp与ffmpeg已由应用管理位于应用数据目录的bin子目录如 macOS 的~/Library/Application Support/wtf.tonho.omniget/bin见 resolve-tools.shsetup 会发现它们并什么都不安装直接复用。第 3 步添加转写密钥可选字幕与本地 Whisper 不需要任何密钥。需要云端转写时请在你的终端里执行输入被隐藏密钥绝不经过 Claudebash claude-plugin/omniget/scripts/keys.sh set这是 keys.sh 的交互模式逐项提示输入 OpenAI 与 Gemini 密钥read -r -s隐藏输入写入~/.config/ai-keys.env文件权限 600且密钥值通过 stdin 传递而非命令行参数避免出现在ps与 shell 历史中keys.sh。已有密钥的字段留空即可保留原值。随后验证可用性bash claude-plugin/omniget/scripts/keys.sh check该命令会读取环境变量或~/.config/ai-keys.env中的密钥永不打印密钥值并对各自提供方发起真实探测请求OpenAI请求https://api.openai.com/v1/models200 表示 working401/403 表示密钥被拒000 表示网络超时Gemini请求https://generativelanguage.googleapis.com/v1beta/models200 表示 working400/401/403 表示密钥被拒。注意只有 OpenAI 和 Gemini 支持转写。OpenRouter 没有语音转文本speech-to-text端点此处不支持。密钥文件位置可用OMNIGET_KEYS_FILE环境变量覆盖默认~/.config/ai-keys.env。CLI 模式下keys.sh set会拒绝执行并提示必须使用交互终端keys.sh这正是为了让密钥不流经 Claude 会话的设计。转写后端的选择阶梯--backend auto默认按以下优先级选用第一个可用的后端源自 README.mdcaptions——yt-dlp抓取平台自带字幕。免费、即时local——whisper-cliwhisper.cpp ggml 模型。免费、离线、私密mlx—— Apple Silicon 上的mlx_whisper。免费、离线、比 whisper-cli 更快gemini—— Gemini 2.5 Flash需要GEMINI_API_KEY。成本约每小时几美分原生支持音频openai—— 需要OPENAI_API_KEY。whisper-1返回时间戳--model gpt-4o-transcribe更准确但仅文本。可用--backend local|mlx|gemini|openai|captions强制指定。API 密钥从环境变量或~/.config/ai-keys.env读取绝不打印。本地 Whisper 模型管理--local安装 whisper-cli 后若尚无模型setup 会询问是否下载默认模型large-v3-turbo-q5_0约 547 MB。模型下载由 get-model.sh 完成从 Hugging Face 的ggerganov/whisper.cpp仓库拉取 ggml 模型并校验 SHA-256 哈希不一致即丢弃重来。也可手动指定bash claude-plugin/omniget/scripts/get-model.sh large-v3-turbo-q5_0 # 547 MB bash claude-plugin/omniget/scripts/get-model.sh base # 141 MB bash claude-plugin/omniget/scripts/get-model.sh small # 465 MB模型存放优先 OmniGet 应用的models/whisper目录否则放在技能缓存~/.cache/omniget-skill/models。运行时模型自动选择顺序resolve-tools.shOMNIGET_WHISPER_MODEL显式指定 large-v3-turbo优先量化版mediumsmallbasetiny。日常维护站点变更时如何恢复站点会变、提取器会失效——这是所有下载器都要面对的正常现象。当原本可用的站点突然失败时bash claude-plugin/omniget/scripts/setup.sh --update该命令会升级yt-dlp并重新下载最新omniget-cli。脚本同时也检查转写密钥状态一并报告setup.sh。私有与限流内容Instagram、X没有下载器能对 Instagram/X 永远有效它们按 IP 限流、把内容关在登录墙后OmniGet 对其中大部分内容也依赖已登录会话。若抓取返回empty media response或HTTP 400/429通常只是临时限流——等几分钟重试即可如果帖子私有或需登录技能会用你已登录的浏览器自动重试自动检测浏览器。macOS 上第一次读取会弹出一次性 Keychain 提示——允许它。若浏览器有多个 profile 且默认的没登录可钉住登录的那个export OMNIGET_COOKIES_FROM_BROWSERchrome:Profile 3在 OmniGet 应用里登录该站点同样有效——应用内的 cookie 会优先于任何浏览器被复用。这背后的实现逻辑在 resolve-tools.sh 的og_run_ytdlp首次尝试失败后通过og_should_retry_with_cookies判断错误是否属于限流/需登录类别若是则自动检测浏览器og_detect_browser按 chrome → brave → edge → firefox → safari 的常见登录概率排序并追加--cookies-from-browser重试已使用过 cookie 的请求不会重复重试。cookie 的解析顺序是OmniGet 应用持有的该站点 cookies.txt →OMNIGET_COOKIES_FROM_BROWSERresolve-tools.sh。YouTube、TikTok、Reddit、Vimeo、Twitch 等公开内容以及 yt-dlp 支持的约 1,800 个站点都很可靠无需任何上述处理。另外请记住插件的使用边界只下载用户明确要求的内容绝不绕过 DRM 或付费墙只使用用户已有的会话OmniGet cookie 账户或--cookies-from-browser字幕覆盖帖子描述评论不在范围内。故障排查症状处理状态不明需要全面体检/omniget:doctor内部执行 doctor.sh--check-keys报告 omniget-cli/yt-dlp/ffmpeg/ffprobe/whisper-cli/mlx_whisper、Whisper 模型、两个密钥、应用与输出目录状态yt-dlp not found运行/omniget:setup某个站点突然失败setup.sh --update一切就绪但单个 URL 失败查看脚本打印的提示——它能区分限流、需登录与DRM三类原因错误提示分类由 resolve-tools.sh 的og_explain_error实现把 yt-dlp/omniget-cli 的原始 stderr 翻译成可执行的建议匹配empty media response、HTTP 400、HTTP 429、Too Many Requests等 → 提示限流等待重试或检查登录匹配Sign in to confirm、login required、Private video、HTTP 401/403等 → 提示需要登录会话指引 cookie 方案匹配DRM、SAMPLE-AES、FairPlay、Widevine→ 明确告知该流受 DRM 保护、OmniGet 不绕过 DRM匹配Unsupported URL、extractor is broken→ 提示更新工具setup.sh --update匹配格式不可用 → 提示去掉--quality重试。/omniget:doctor还可直接输出 JSON 结构doctor.sh --json便于脚本化集成与二次解析。卸载/plugin uninstall omniget下载的工具与模型存放在~/.cache/omniget-skill/若使用了 brew/winget 则还有系统常规位置需要释放空间时可手动删除。主要目录速览源自 resolve-tools.sh目录/变量默认位置技能缓存OMNIGET_SKILL_CACHE~/.cache/omniget-skill含bin子目录技能自装二进制~/.cache/omniget-skill/bin输出目录OMNIGET_DIR~/Downloads/omniget应用数据目录OMNIGET_DATA_DIRmacOS~/Library/Application Support/wtf.tonho.omnigetLinux${XDG_DATA_HOME:-$HOME/.local/share}/wtf.tonho.omnigetWindows${APPDATA:-$HOME/AppData/Roaming}/wtf.tonho.omniget常用环境变量速查变量含义OMNIGET_DIR输出目录默认~/Downloads/omnigetOMNIGET_DATA_DIROmniGet 应用数据目录按 OS 自动检测OMNIGET_TOOL_YT_DLP、OMNIGET_TOOL_FFMPEG等显式指定二进制路径OMNIGET_WHISPER_MODEL本地后端显式指定 ggml 模型文件OMNIGET_COOKIES_FROM_BROWSERchrome/firefox/safari/edge用于登录门槛内容OMNIGET_KEYS_FILE替代~/.config/ai-keys.env的密钥文件快速验证与自测整个插件是可测试的。运行单元测试python3 -m unittest discover -s tests bash tests/test_keys.sh测试覆盖密钥脚本与转写工具tests 目录下有test_keys.sh、test_retry.sh、test_gemini_norm.py、test_srt_tools.py可用于在 CI 或升级后确认插件脚本行为未回归。完成上述三步安装插件 → 运行/omniget:setup→ 按需配置密钥再配合/omniget:doctor体检与--update维护习惯OmniGet 的 Claude Code 下载与转写链路即可长期稳定运行。【免费下载链接】omnigetDownload Udemy and Hotmart courses, YouTube videos, music and books — 1,800 sites, no terminal. Free open-source desktop app for Windows, macOS and Linux, with a built-in course player, PDF/EPUB reader and music library. Powered by yt-dlp. Your files stay on your computer.项目地址: https://gitcode.com/GitHub_Trending/om/omniget创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考