GitHub

使用手册

在 Linux 登录时启动 Motrix

在 Linux 上，请通过桌面环境配置登录启动。Motrix 不会创建或移除 Linux 启动项。配置后，桌面应用会在你登录图形会话时启动。

Note

Motrix 2.0.0-beta.41 在 Linux 上显示了“登录时启动”开关，但该开关不会注册启动项。即使之前开启过，也需要按照下面的步骤添加 Motrix。

使用桌面的启动设置

对于 DEB、RPM、Arch 安装包，以及已出现在应用菜单中的 Flatpak 和 Snap，这是最方便的方式。

桌面环境添加 Motrix 的位置
KDE Plasma在系统设置中搜索“自动启动”，选择“添加应用程序”（部分版本为“添加程序”），然后选择 Motrix。
GNOME打开“优化 → 启动应用程序”，添加应用并选择 Motrix。如果没有优化工具，请先安装发行版提供的 GNOME Tweaks 软件包。
Xfce打开“会话和启动 → 应用程序自启动”，添加 Motrix 的启动命令。

其他桌面可以在设置中查找“启动应用程序”或“自动启动”。菜单名称可能随桌面版本和语言而变化。

使用 AppImage 时，先把文件放在固定位置，再到“Motrix → 设置 → 集成”中启用桌面集成，这样就能从应用列表选择它。如果列表中没有 Motrix，也可以使用文件的完整路径添加启动命令。

注销后重新登录，检查启动项是否生效。只需添加一次：如果已经手动配置过，或者桌面会恢复上次会话中的 Motrix，请避免重复添加。

手动添加启动项

请使用普通用户账户，在宿主桌面的终端中操作。Flatpak 和 Snap 用户也应在宿主系统上创建启动项，而不是在应用沙箱内操作。

  1. 创建当前用户的自启动目录：

    mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/autostart"

  2. 使用文本编辑器，在该目录中创建 motrix-manual.desktop。下面的示例用于启动官方 Motrix Turbo Flatpak：

    [Desktop Entry]
Type=Application
Name=Motrix
Exec=flatpak run app.motrix.native
Terminal=false

  3. 根据安装方式修改 Exec 的值：

    安装方式启动命令
    DEB／RPM／Arch 安装包使用已安装桌面应用的启动命令，通常为 motrix 或以 /motrix 结尾的绝对路径。不确定时，从应用启动器的属性中复制命令。
    AppImage"/home/YOUR_USER/Applications/Motrix.AppImage"，请替换为实际、固定的文件路径。
    官方 Turbo Flatpakflatpak run app.motrix.native
    官方 Snapsnap run motrix

    先在终端测试选定的命令，确认它会打开 Motrix 桌面应用。如果 motrix 打开的是独立的 Motrix CLI，请改用桌面启动器中的可执行文件路径。旧版 Flatpak net.agalwood.Motrix 使用不同的应用 ID，复制命令前请核对已安装的软件包。

  4. 保存文件，注销后重新登录。

AppImage 必须使用完整路径，桌面启动项的 Exec 字段不会展开 ~ 或 $HOME。请保留 AppImage 的可执行权限；移动或重命名文件后，需要更新启动项。不要复制 /tmp/.mount_* 下的临时路径。

Hyprland 和自定义会话

桌面启动项需要会话执行 XDG 自启动文件才能生效。由 UWSM 管理的 Hyprland 会话会自动启用这项支持。其他会话配置需要使用自身的启动机制，或者配置 XDG 自启动执行器。

例如，尚未添加 Motrix 启动项的 Hyprland 会话，可以通过下面的配置启动官方 Flatpak：

exec-once = flatpak run app.motrix.native

会话启动命令和 XDG 自启动项选择一种即可。在 Arch、Omarchy 等系统上，也应先检查实际使用的会话配置。详见 Hyprland 会话文档。

选择窗口行为

在“Motrix → 设置 → 通用 → 打开 Motrix 时”中，选择“打开主窗口”或“在系统托盘中启动”。这项设置也适用于手动打开应用。启动到托盘需要桌面提供可用的系统托盘；如果登录后找不到 Motrix，请先选择“打开主窗口”。

上面的命令按普通方式启动 Motrix，无需添加 --opened-at-login=1。

关闭自启动或排查问题

  • 在添加启动项的桌面设置中移除或禁用 Motrix。如果创建了 motrix-manual.desktop，请从当前用户的自启动目录删除该文件。如果使用 Hyprland 启动命令，请删除对应的 exec-once 行。
  • 如果 Motrix 没有启动，先在终端执行启动项中的命令，解决可执行文件不存在、AppImage 已移动或软件包 ID 错误等问题。
  • 如果手动执行命令正常，请检查启动项是否位于宿主用户的自启动目录、是否被 Hidden=true 禁用，以及会话是否执行 XDG 自启动项。
  • Flatpak 和 Snap 应使用 flatpak run 或 snap run，沙箱内部的可执行文件路径不能作为宿主系统的启动命令。

桌面相关细节可参考 XDG 自启动规范、KDE 自启动指南和 GNOME 启动指南。