OmniGet 详细部署教程

OmniGet 是一款功能强大的开源桌面应用，它集下载、播放、阅读和笔记于一体，支持从超过 1,800 个网站（包括 YouTube、Udemy、Hotmart、TikTok 等）下载视频、音频和课程，并内置了播放器、阅读器和音乐库。

本教程将引导你完成在不同操作系统上的安装与初始配置。

1. 下载与安装

OmniGet 为所有主流操作系统提供了便捷的安装包，无需命令行或额外配置即可使用。

Windows

推荐方式： 从 Releases 页面下载 .exe 文件，双击即可运行。此为便携版，无需安装，可放在任何位置。
其他安装方式：
- 下载 .msi 安装程序进行标准安装。
- 使用命令行工具 winget 安装（需 Windows 10 1809+ 或 Windows 11）：
  1
  winget install --id tonhowtf.OmniGet --exact

首次启动警告：Windows SmartScreen 可能会显示蓝色警告。点击 “更多信息” (More info)，然后选择 “仍要运行” (Run anyway) 即可。

macOS

从 Releases 页面下载 .dmg 文件。
打开 .dmg 文件，将 OmniGet.app 拖入 Applications 文件夹。

首次启动处理（重要）：
macOS Gatekeeper 会阻止未签名的开源应用。打开终端，运行以下两条命令来解除限制：
1
2
xattr -cr /Applications/omniget.app
codesign --force --deep --sign - /Applications/omniget.app
之后，就可以正常打开 OmniGet 了。此操作只需执行一次。

Linux

OmniGet 为不同发行版提供了多种格式：

Debian/Ubuntu：推荐下载 .deb 包，双击即可安装，兼容性最好。
Fedora/openSUSE：下载 .rpm 包进行安装。
其他发行版 (通用)：下载 .AppImage 文件。
- 重要提示：Debian 12+ 和 Ubuntu 24.04+ 默认不带 FUSE 2，直接运行 AppImage 会报错。请先安装 libfuse2，或使用 --appimage-extract-and-run 参数运行。
  1
  2
  3
  4
  5
  6
  # 方式一：安装依赖
  sudo apt install libfuse2
  ./omniget.AppImage
  
  # 方式二：解压后运行
  ./omniget.AppImage --appimage-extract-and-run
Flatpak (推荐)：如果你使用支持 Flatpak 的发行版，也可以从 Flathub 安装：
1
flatpak install flathub wtf.tonho.omniget

2. 首次启动与设置向导

第一次打开 OmniGet 时，会自动启动一个设置向导，引导你完成基本配置。强烈建议按步骤完成。

步骤	配置内容	说明
1. 欢迎	语言与主题	从9种语言中选择，并设置系统、浅色或深色主题。
2. 下载文件夹	默认输出目录	选择下载文件的存放位置，默认为系统的“下载”文件夹。
3. 依赖项	yt-dlp 与 FFmpeg	向导会检查这两个核心工具。点击“全部安装”即可自动完成配置，无需手动操作。
4. 插件	推荐功能插件	可按需选择安装“课程下载器”、“Telegram下载器”和“媒体转换器”插件。这些插件也可在后续从应用内的“市场”安装。
5. 全局快捷键	`Ctrl+Shift+D`	启用后，在任何地方复制链接，按下此快捷键即可后台下载。
6. Discord RPC	状态分享	可选项，决定是否在 Discord 上显示你正在播放的内容。

3. 核心功能体验

执行首次下载

安装完成后，使用 OmniGet 下载内容非常简单：

粘贴链接：在主界面顶部的输入框中，粘贴任意支持的链接（如 YouTube 视频、Udemy 课程等）。
预览与选择：应用会解析链接并展示可用的画质、格式等选项。
点击下载：选择你需要的质量，点击下载即可。

启用便携模式（可选）

如果你希望将 OmniGet 安装在U盘等移动设备上，使所有配置和数据都保存在软件目录下，可以启用便携模式 ：

在 OmniGet 可执行文件（如 omniget.exe）所在的文件夹中，创建一个名为 portable.txt 或 .portable 的空文件。
重新启动 OmniGet。此后，所有设置、数据库、插件等都会保存在该文件夹下的 data 子目录中。

设置浏览器扩展（可选）

OmniGet 提供 Chrome 和 Firefox 浏览器扩展，支持一键将当前页面发送至应用下载。

从项目的 Releases 页面或浏览器扩展商店安装。
安装后，在支持网站上，点击扩展图标即可将视频或页面添加到 OmniGet 的下载队列。

4. 常见问题与故障排除

问题	解决方法
macOS 无法打开应用	执行“首次启动处理”中的两条终端命令。
Linux AppImage 报 libfuse 错误	安装 `libfuse2` (`sudo apt install libfuse2`) 或使用 `--appimage-extract-and-run` 参数运行。
下载依赖工具失败	确保网络连接正常。如果自动安装失败，可手动安装 `yt-dlp` 和 `FFmpeg` 并将其添加到系统环境变量 `PATH` 中。
下载内容付费/受保护	OmniGet 只能下载你的登录会话可以访问的内容（如你已购买的课程）。它不能绕过 DRM 或付费墙。
如何更新	应用内置自动更新功能，会在后台静默更新。也可以定期检查 Releases 页面获取新版。