先说问题:下载这件事,工具为什么越攒越多
想把自己买的网课存到本地慢慢看,要装一个课程下载工具;想存 YouTube 视频,得记住 yt-dlp 那一长串参数,隔两个月不用就忘光;想存 Instagram 的动态、X 上的视频、Pinterest 的图板,又得各找一个网页下载站,界面全是广告,还动不动失效。工具散落一地,每个只管一摊,下载完的文件还得自己另外找播放器、找转码工具、找字幕工具。
LibreGet 的思路是把这一摊事收进一个桌面窗口:粘贴链接 → 预览选清晰度 → 下载 → 在同一个应用里播放、阅读、转录、转换、管理。底层该用 yt-dlp 的地方用 yt-dlp,该用原生解析的地方用原生解析,全部封装好,不用碰终端。
项目地址:https://github.com/OpenSelena/libreget
本篇主线:它是什么 → 能下什么 → 核心工作流 → 浏览器扩展配对 → 下完之后的管理与工具 → 给 AI 助手用的接口 → 三平台安装与首次启动排障 → 便携模式。
它是什么
LibreGet 是一个开源免费的桌面下载管理器,用 Tauri 2.0 + Rust + Svelte 编写,GPL-3.0 协议,Windows、macOS、Linux 三平台全覆盖。它的定位很明确:免费、无账号、无广告、不收集你的下载记录,所有文件只落在你自己的电脑上。
几个关键设计先交代清楚:
- 引擎自动托管:yt-dlp 和 FFmpeg 由应用自己下载、校验 SHA-256、保持更新,你不需要装 Python、不需要配环境变量、不需要开终端。
- 原生解析优先:课程、Instagram、X、Pinterest、Bilibili、Telegram、种子这些高频场景有原生解析器,其余 1800 多个站点交给 yt-dlp 兜底。
- 纯本地运行:没有官方服务器在中间中转。应用自己发起的网络请求只有三类——你让它下载的站点、去 GitHub 检查更新、以及你配置的 AI 服务(用 AI 工具时)。
能下什么
在线课程:38 个平台
内置的课程插件支持 38 个学习平台,包括 Udemy、Hotmart、Coursera、Domestika、Skillshare、Kiwify、Rocketseat 等。在应用内登录你的账号后,它会列出你已购买的课程,打开课程大纲勾选要下的章节,连同课件附件一起下载,支持断点续下和连续编号整理。这里的口径要说清:它只能下载你自己账号已经购买、能正常打开的课程,带 DRM 保护的课时会被自动跳过并报告,不做任何破解。买过的课趁平台还在先备份到本地,是这类工具最正当的用途。
视频与音频:1800 多个站点
YouTube(视频、播放列表、频道、直播回放、章节、SponsorBlock 跳过)、Instagram、TikTok、X、Reddit、Twitch(点播、剪辑、直播)、Vimeo、Bluesky、Threads、Pinterest、抖音等热门站点有专门优化,其余长尾站点由 yt-dlp 覆盖,总数 1800 以上。保存格式上,视频可存 MP4、MKV、WebM,音频可存 MP3、M4A、Opus、FLAC、WAV,字幕可存 SRT、VTT、ASS,可内嵌也可旁挂。
Bilibili:登录后的完整体验
登录自己的 Bilibili 账号后,按账号权限下载 4K、HDR、杜比视界、高清无损音频;弹幕可导出为 XML、ASS 或 JSON,还能生成供 Kodi 和 Jellyfin 识别的 NFO 文件,支持番剧、课程、收藏夹、稍后再看、历史记录等 11 类链接。
图库与其它
图库走 gallery-dl 引擎,覆盖 DeviantArt、Pixiv、ArtStation、Flickr、Tumblr、Imgur 等 250 多个站点,可整站、整画师、整图板备份。另外还支持 .torrent 文件与磁力链接(内置 BitTorrent 客户端)、Telegram 频道与群组里的文件(内置 Telegram 插件,按频道自动归档到 LibreGram/<频道名>/ 文件夹)、批量粘贴链接或导入 .txt 批量下载、两台 LibreGet 之间用短口令互传文件。
和其它方案比一比
| 维度 | LibreGet | 裸用 yt-dlp | 单站网页下载站 | 付费课程下载器 |
|---|---|---|---|---|
| 站点覆盖 | 课程、Instagram、X、Pinterest、Bilibili、Telegram、种子原生支持,另加 yt-dlp 的 1800+ | 1800+ | 一个 | 一两个平台 |
| 安装门槛 | 下载一个文件打开即用 | Python、PATH、FFmpeg、记参数 | 无 | 安装包加许可证密钥 |
| 登录内容 | 浏览器扩展转发你的登录态 | 手动导出 --cookies | 基本不行 | 部分支持 |
| 下载队列 | 断点续传、退避重试、规则分流、订阅频道自动下新 | 一次一条命令 | 无 | 不一定 |
| 下完之后 | 播放器、阅读器、闪卡、笔记、158 个工具 | 只有文件 | 只有文件,还常被转码 | 只有文件 |
| 价格与协议 | 免费,GPL-3.0 | 免费,Unlicense | 免费但带广告 | 订阅付费 |
结论很直白:如果你就住在终端里、只要文件本身,裸用 yt-dlp 就够了;如果你想要一个窗口管完下载加整理,LibreGet 是目前开源里完成度最高的那个。
核心工作流:一分钟下第一个文件
- 打开 LibreGet,首次启动选好语言和主题,点一下它就自动装好 yt-dlp 和 FFmpeg(下载后先验 SHA-256 再运行)。
- 复制任意链接:YouTube 视频、Instagram 短视频、X 帖子、Pinterest 图板、磁力链接、直链文件都行。
- 粘贴到主页的输入框,它自动识别站点,展示标题、缩略图和可选清晰度,选好按回车开下。
下载页会实时显示速度、阶段和预计剩余时间(数据直接读自下载引擎,卡住就是卡住,不会假装还剩 3 秒)。几个用顺手之后回不去的设计:
- 断点续传:中断的任务保留部分文件,下次接着下;遇到限流自动退避重试;每个站点的并发连接数自适应——YouTube 可以拉到 16 路分片并行,返回 429 的站点自动降速。
- 全局热键:在任何地方复制链接后按
Ctrl+Shift+D(macOS 是Cmd+Shift+D),后台直接开下,不用切窗口;Ctrl+Shift+M只抓音频,YouTube 链接直接变 MP3。这两个热键默认关闭,在「设置 → 下载 → 剪贴板与热键」里开启,也可以改键。 - 一次设置长期生效:默认清晰度、纯音频格式、字幕语言与格式、文件名模板、按平台分文件夹、跳过已存在文件、限速、并发数都可以预设;规则功能可以把某个频道或站点固定分流到指定文件夹和清晰度;订阅的频道会在后台检查更新,有新内容自动下载并托盘通知。
- 每条任务留底:每个下载任务都保存它实际执行的 yt-dlp 命令,打开就能看,想改参数重试不用重新拼命令。
命令行党也有份:每次发布都带 libreget-cli,常用法如下:
libreget info <url> # 只看标题、格式和大小,不下载libreget download <url> -q 1080 -o ~/Videoslibreget download <url> --audio-only --subs en,zhlibreget batch links.txt -m 3 # 一行一个链接,3 个并发libreget import-cookies cookies.txt # Netscape 格式浏览器扩展:登录内容的关键一环
很多内容不登录看不到:你买的课、仅粉丝可见的视频、Instagram 的限时动态。LibreGet 处理登录态的方式是装一个浏览器扩展,由它把你在浏览器里的登录 Cookie 和来源页一起转发给应用——前提永远是那是你自己的账号、你自己的浏览器会话,它不绕过任何登录墙和付费墙。
扩展在已识别的站点(YouTube、Instagram、TikTok、X、Reddit、Twitch、Pinterest、Bluesky、Telegram、Vimeo、Udemy、Hotmart、Bilibili、SoundCloud 等)上点图标或按 Alt+O 一键发送当前页;对其它站点,它会嗅探页面里的 MP4、HLS、DASH、WebM 和音频流列在弹窗里供你挑。装法分三档,由简到繁:
第一档:应用内安装(推荐,不用下载任何压缩包)
- 打开 LibreGet,进入「设置 → 插件 → 浏览器扩展」,点 Chrome 旁边的「更新/安装」,它会把内置的扩展复制到一个文件夹并自动打开。
- 在 Chrome(Edge、Brave 等 Chromium 浏览器同理)地址栏输入
chrome://extensions。 - 打开右上角的「开发者模式」。
- 点「加载已解压的扩展程序」,选中刚才打开的文件夹。
- 工具栏出现 LibreGet 图标,一个选项页会自动打开并寻找应用。
- 回到 LibreGet 同一设置页,点「配对扩展」,几秒后显示「扩展已连接」,选项页变绿,完成。
第二档:用发布包里的 zip。每个版本都附带 libreget-chrome-extension-vX.Y.Z.zip,解压后按第一档第 3 步往下走即可。适合浏览器和应用不在同一台机器,或者帮别人装的场景。
第三档:Firefox 与手动配对。Firefox 在同样的设置页点 Firefox 的「更新/安装」,再打开 about:debugging#/runtime/this-firefox,点「临时加载附加组件」选导出文件夹里的 manifest.json(注意 Firefox 临时组件重启后会掉,要重装一次,等上架官方商店后就没这问题;Safari 暂不支持)。如果自动配对超时,打开扩展的选项页,把 LibreGet 里显示的配对令牌粘贴进去即可——应用只监听本机 127.0.0.1 的 47720–47729 端口,令牌每台机器独立生成,数据不出本机。
小提醒:如果扩展装了但 LibreGet 没开着,点击会走 libreget:// 链接唤起应用排队,但带不了 Cookie;Chrome 第一次问是否允许时记得勾「始终允许」。
下完之后:不只是个下载器
LibreGet 真正和其它下载工具拉开差距的是下载之后:
- 内置播放器与阅读器:下完的课程直接在应用里播,PDF 直接在应用里读,还有闪卡和笔记功能,备份下来的课不用再倒腾到别的软件里。
- 158 个内置小工具(25 类):每个工具是一个独立的 Rust 命令,全部在本机运行。挑最实用的几类说:
- 语音与字幕(8 个):用 whisper.cpp 本地离线转录音视频成字幕(模型按需下载)、字幕翻译、文字转语音、按字幕配音等。
- 视频编辑(14 个):截取片段、转码换容器/编码/分辨率、精确压缩到指定大小(如 10 MB 发 Discord)、视频转 GIF、剪静音段、字幕格式互转与烧录、字幕对轴、画面防抖与修复、录屏。
- PDF(13 个):合并、拆分、压缩、转换、OCR、修复、加解密与权限、水印页码、裁边、生成目录、转 Markdown 等。
- 平台工具:YouTube 工具 11 个(封面、评论导出、双语字幕合并等)、Instagram 24 个、X 10 个、Pinterest 10 个,另有图片、文档、音频(响度标准化、降噪)、系统、CTF 分析等类别。
- 命令面板:
Ctrl+K(macOSCmd+K)直达任意页面、设置或工具;还有 14 套主题、12 种界面语言(含简体中文)可选。
下完的影音文件如果量大,建议归档进媒体库统一管理——本系列的 Jellyfin 影音库 正是干这个的;散文件想跨设备随时取用,可以放进 Alist 网盘聚合;多台设备之间的文件夹同步方案见 文件同步篇。
给 AI 助手用的接口:MCP 与插件
这是 LibreGet 一个很超前的设计:它内置了 MCP 服务器。工具的内部实现本来就是「JSON 进、JSON 出」的独立命令,所以开放给 AI 助手几乎是顺手的事。
- 应用内 MCP 服务器:在「工具 → AI → MCP 服务器」里开启后,它通过与浏览器扩展相同的本机桥接通道、同一套每机独立令牌,对外提供 37 个工具。助手可以把链接加入下载队列并查看、暂停、恢复、取消任务,可以合并拆分 PDF、转录文件、文字转语音、OCR、图片缩放去重、文件搜索等。设置页直接给出 Claude Code、Claude Desktop、Cursor、VS Code、Goose、Codex 的现成配置片段,复制粘贴即可,不用自己拼。
- Claude Code 插件:仓库里的
claude-plugin/文件夹提供一个不需要桌面应用的插件,粘贴视频、音频或社交帖子链接并说明需求,libreget-fetch与libreget-transcribe两个技能会自动触发;也可以用斜杠命令显式调用:
/plugin marketplace add /path/to/libreget/claude-plugin/plugin install libreget/libreget:setup # 一次确认后装好 yt-dlp、ffmpeg 与 libreget-cli/libreget:fetch <url> [--audio] # 下载媒体到 ~/Downloads/libreget/libreget:transcribe <url|file> # 先取字幕,再本地 whisper.cpp,最后才用云端/libreget:research <url> # 字幕加转录整理成带 [mm:ss] 引用的 Markdown 笔记/libreget:doctor # 检查装了什么、缺什么、怎么补WARNINGMCP 服务器和浏览器扩展共用同一个本机令牌,令牌只在本机使用、不要外发给任何人或粘贴到在线服务里;给助手开 MCP 等于允许它调用你电脑上的下载与文件工具,装好后先在小任务上试一轮,确认行为符合预期再放手批量使用。
安装:三平台各自的拿法
所有版本都在 GitHub 的 Releases 页发布,应用内可自动更新。
| 系统 | 下载什么 | 其它装法 |
|---|---|---|
| Windows 10 / 11 | libreget_x.y.z_x64-setup.exe(安装版)、libreget_x.y.z_x64-portable.exe(便携版)、libreget_x.y.z_x64_en-US.msi(批量部署) | winget install -e --id OpenSelena.LibreGet |
| macOS 10.15+ | Apple 芯片用 libreget_x.y.z_aarch64.dmg,Intel 用 libreget_x.y.z_x64.dmg | brew install --cask OpenSelena/tap/libreget |
| Linux | Debian/Ubuntu 用 .deb,Fedora/openSUSE/RHEL 系用 .rpm,其它发行版用 .AppImage(均含 x86_64 与 ARM64) | AppImage 靠随附的 .zsync 文件自更新 |
命令行一把梭的装法:
winget install -e --id OpenSelena.LibreGetbrew install --cask OpenSelena/tap/libreget务必只从 GitHub 官方 Releases、winget 或上述 Homebrew 仓库安装,不要从来路不明的下载站拿安装包——这类热门免费工具最容易被捆绑恶意软件重新打包。
便携模式:整个应用装进 U 盘
Windows 下在便携版 .exe 同目录新建一个空文件 portable.txt(或 .portable),重新启动后,设置、数据库、Cookie、插件、缓存以及 yt-dlp 和 FFmpeg 全部搬到 exe 旁边的 data 文件夹,不碰系统的 AppData。整个文件夹拷进 U 盘,换台电脑插上就能用,自己的下载环境随身走。
常见问题与排障
Q:Windows 第一次打开弹出 SmartScreen 蓝色警告,怎么办? A:这是因为应用没有购买付费代码签名证书,开源桌面软件常见。点「更多信息」→「仍要运行」即可,只需处理一次。前提是你从官方渠道下载的安装包。
Q:macOS 提示应用「已损坏」打不开? A:把应用拖进「应用程序」后,打开终端执行下面两行去掉隔离属性并本地签名,之后正常从启动台打开,同样只需一次:
xattr -cr /Applications/libreget.appcodesign --force --deep --sign - /Applications/libreget.appQ:Linux 上 AppImage 报 libfuse 错误起不来?
A:Debian 12+、Ubuntu 24.04+ 不再自带 FUSE 2。装一下 sudo apt install libfuse2,或者用 ./libreget.AppImage --appimage-extract-and-run 方式运行;用 .deb 包则完全没有这个问题。
Q:Linux 下播放器黑屏或应用直接闪退?
A:界面用 WebKitGTK 渲染,音视频走 GStreamer 解码,缺插件会导致播放器一出现就崩。多数桌面发行版自带,Arch 和精简镜像需手动装齐(.deb、.rpm 会自动带依赖,主要是 AppImage 和手动构建会遇到):
sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-libav # Debian、Ubuntusudo dnf install gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugin-libav # Fedorasudo pacman -S gst-plugins-good gst-plugins-bad gst-libav # ArchQ:需要装 Python 或 Node 吗?平时要开终端吗? A:都不需要。下载应用、打开、粘贴链接三步完事;唯一的终端操作就是上面 macOS 那次性的两行命令。
Q:登录后才能看的内容下不了? A:先确认浏览器扩展已装好且显示「扩展已连接」——登录 Cookie 靠它转发;再确认你在浏览器里确实处于登录状态且能正常打开那个页面。应用只能取到你自己会话能打开的内容,带 DRM 的课时会明确跳过并报告,这是设计如此,不是故障。
Q:下载到一半断了、或者站点返回 429? A:直接在下载页点继续即可断点续传;429 是站点限流,应用会自动退避重试并降低该站点的并发,挂着等它自己恢复,不要手动连点重试火上浇油。
Q:它和裸用 yt-dlp 到底什么关系? A:yt-dlp 是它长尾站点的下载引擎,由它内置、校验并自动更新;课程、Instagram、X、Pinterest、Bilibili、Telegram、种子走原生解析。在这之上是队列续传、工具区和格式转换。你在任务详情里能看到每条任务实际跑的 yt-dlp 命令,想接管随时接管。
Q:从源码构建要注意什么?
A:需要 Rust(工具链版本被 rust-toolchain.toml 锁定,因为插件 ABI 依赖它)、Node.js 18+ 和 pnpm:
git clone https://github.com/OpenSelena/libreget.gitcd libregetpnpm installpnpm tauri dev正式构建要用 pnpm tauri build --config '{"bundle":{"createUpdaterArtifacts":false}}',否则会因为缺少发布签名私钥在生成更新包那步停住。普通使用直接下 Releases 就好,不必自己构建。
小结
下载这件事的麻烦从来不在「下不动」,而在工具散、参数多、下完还要二次整理。LibreGet 把课程备份、1800 多站点的视频音频图库下载、断点续传队列、浏览器登录态、播放阅读、转录转换等 158 个小工具,连同给 AI 助手调用的 MCP 接口,全部收进一个免费开源、纯本地运行的桌面窗口里。如果你手上正攒着一堆买过的课和散落各处的下载小工具,它值得成为那个唯一的入口。