跳到主要内容

Linux 安装指南

系统要求​

项目要求
发行版Ubuntu 20.04+ / Debian 11+ / Fedora 38+ / 其他主流发行版
架构x86_64 / amd64
磁盘空间5 GB
依赖libwebkit2gtk-4.1、libmpv（内置播放器）、libfuse2（AppImage 需要）

安装步骤​

Ubuntu / Debian（.deb）​

  1. 前往 下载页面 下载 aividlab_*_amd64.deb。
  2. 在终端执行：
sudo dpkg -i aividlab_*_amd64.deb
  1. 如果提示「依赖关系问题」，继续执行：
sudo apt -f install
  1. 完成后，终端输入 aividlab 即可启动；或在应用菜单中找到图标启动。
  2. 最后，安装内置播放器所需的 libmpv 依赖：
sudo apt install -y libmpv2

Ubuntu 20.04 / Debian 11 中对应的包名为 libmpv1。

Fedora / RHEL / openSUSE（.rpm）​

  1. 前往 下载页面 下载 aividlab*.rpm。
  2. 在终端执行：
sudo dnf install ./aividlab*.rpm

openSUSE 使用 sudo zypper install ./aividlab*.rpm。

  1. 完成后，终端输入 aividlab 即可启动；或在应用菜单中找到图标启动。
  2. 最后，安装内置播放器所需的 libmpv 依赖：
sudo dnf install -y mpv-libs

其他发行版（.AppImage）​

  1. 前往 下载页面 下载 aividlab_*_amd64.AppImage。
  2. 在终端执行：
chmod +x aividlab_*_amd64.AppImage
./aividlab_*_amd64.AppImage
  1. 如提示 FUSE 相关错误，请先安装 libfuse2：
# Debian / Ubuntu
sudo apt install -y libfuse2

# Arch / Manjaro
sudo pacman -S --needed fuse2
  1. 最后，安装内置播放器所需的 libmpv 依赖（按发行版选择）：
# Debian / Ubuntu
sudo apt install -y libmpv2

# Arch / Manjaro
sudo pacman -S --needed libmpv

# Fedora
sudo dnf install -y mpv-libs

注意事项​

  • AppImage 需要可执行权限。 双击没反应时，在文件管理器中右键 → 「属性」→ 勾选「允许作为程序执行」， 或直接在终端执行 chmod +x 后运行。
  • 升级方式。 .deb 用户下载新版本后重新执行安装命令即可；.rpm 用户重新执行 dnf install 覆盖安装即可； AppImage 用户下载新版本替换旧文件即可，配置与数据会自动保留。

卸载​

  • .deb 安装的用户：
sudo apt remove aividlab
  • .rpm 安装的用户：
sudo dnf remove aividlab
  • AppImage 用户：删除 .AppImage 文件即可。
  • 应用数据与配置位于 ~/.local/share/com.aividlab.app，卸载后可手动删除； 已下载的视频在 ~/Downloads/AIVidLab，按需保留。

常见问题​

  • 下载目录没有写权限？ 默认下载到 ~/Downloads/AIVidLab。可在「设置 → 下载」中改到其他位置。

Fedora：视频只有声音、没有画面？​

适用：Fedora（.rpm 安装）上播放视频只有声音没有画面，或应用环境检测提示视频编解码缺失。 Ubuntu / Debian 不受影响——它们的 GStreamer 默认带完整 ffmpeg 解码器。

原因：Fedora 官方仓库出于专利原因，全链路不提供 H.264 视频解码：

  • gstreamer1-plugin-libav 基于 ffmpeg-free（专利剔除版，不含 H.264 解码器）；
  • 默认安装的 noopenh264 只是一个占位 stub 包（libopenh264.so 仅约 11KB，初始化必败）， 作用只是让依赖解析通过，不能真正解码。

因此未经额外配置的 Fedora 上没有任何可用的 H.264 解码器——音频（AAC）正常、视频解码失败， 表现就是「有声无画」。这不是应用或安装包的问题，是系统解码能力缺失。

修复（依次执行，需要 sudo）：

# 1. 启用 Fedora 官方维护的 Cisco openh264 仓库
sudo dnf config-manager set fedora-cisco-openh264.enabled=1

# 2. 安装真正的 openh264，--allowerasing 用于顶替 noopenh264 stub
sudo dnf install openh264 --allowerasing

# 3. （可选，推荐）补齐常用 GStreamer 插件
sudo dnf install gstreamer1-plugin-libav gstreamer1-plugins-bad-free gstreamer1-plugins-good
备注

Fedora 40 及更早版本使用 dnf4，第 1 条命令请改用 sudo dnf config-manager --set-enabled fedora-cisco-openh264。

完成后重启应用再播放。应用环境检测失败时弹出的修复命令与上面一致，可直接复制执行。

验证（任选一个本地 H.264 mp4 文件）：

gst-launch-1.0 -v filesrc location=视频文件.mp4 ! decodebin ! fakesink

不再出现「无法初始化支持库」/ Failed to create OpenH264 decoder 即为正常。

想要 HEVC（H.265）等更多格式？ openh264 只覆盖 H.264。如需 HEVC 等格式， 需另装 RPM Fusion 的完整 ffmpeg（先按其官网说明启用 free/nonfree 仓库）：

sudo dnf install ffmpeg --allowerasing