qBittorrent下载完成无提示需配置通知：一、GUI中启用“显示下载完成通知”和“启用系统通知”；二、Windows可用Python脚本调用win10toast-click；三、macOS在偏好设置→通知页开启并选声音；四、Linux需确保libnotify正常且桌面环境允许通知。

如果您已启用qBittorrent但未收到下载完成提示，可能是通知功能未开启或未正确配置。以下是针对不同平台和方式的桌面通知设置方法：

一、启用内置系统弹窗通知（Windows/macOS/Linux通用）

该方法依赖qBittorrent原生GUI的通知模块，无需额外工具，直接调用操作系统通知服务。

1、启动qBittorrent客户端，点击顶部菜单栏“选项” → “设置”。

2、在左侧导航栏中选择“下载”选项卡。

3、向下滚动至“运行外部程序”区域下方，找到“显示下载完成通知”复选框并勾选。

4、确认勾选“启用系统通知”（部分版本显示为“Show desktop notifications”）。

5、点击“确定”保存设置，后续种子完成时将触发系统级桌面弹窗提醒。

二、通过Python脚本实现Windows 10/11桌面通知

当qBittorrent GUI不可用（如仅运行WebUI或Docker容器），或需自定义通知内容时，可利用其“下载完成后运行外部程序”功能调用Python脚本。

1、安装win10toast-click模块：pip install win10toast-click。

2、创建notify.py文件，写入以下内容：

import sys
from win10toast_click import ToastNotifier
toaster = ToastNotifier()
torrent_name = sys.argv[1] if len(sys.argv) > 1 else "未知任务"
toaster.show_toast("qBittorrent", f"✅ 下载完成：{torrent_name}", duration=5)

3、返回qBittorrent设置 → “下载”选项卡 → “Torrent完成时运行外部程序”，输入完整路径：python C:\path\to\notify.py "%N"。

4、确保系统已允许应用发送通知（Windows设置 → 系统 → 通知 → 允许qBittorrent或Python相关进程）。

三、macOS平台启用原生通知并配置声音

macOS使用统一通知中心，qBittorrent通过NSUserNotification API集成，支持图文+声音提醒。

1、打开qBittorrent → 菜单栏“qBittorrent” → “偏好设置” → “通知”标签页。

2、勾选“下载完成时显示通知”。

3、在“声音”下拉菜单中选择一种提示音，或勾选“播放默认提示音”。

4、可选：点击“测试通知”按钮验证是否正常弹出并发声。

5、若通知未出现，请检查系统设置 → “通知中心” → 找到qBittorrent → 确保“允许通知”已开启且未设为静音。

四、Linux GNOME/KDE桌面环境适配

Linux发行版依赖桌面环境的D-Bus通知服务（如libnotify），需确保通知守护进程正常运行且qBittorrent具备调用权限。

1、终端执行命令验证通知服务可用：notify-send "测试" "qBittorrent通知正常"。

2、进入qBittorrent设置 → “下载” → 勾选“显示下载完成通知”。

3、如无响应，检查GNOME设置 → “通知” → 确认qBittorrent未被屏蔽；KDE用户需确认“Plasma工作空间” → “通知”中“qBittorrent”条目状态为启用。

4、部分Flatpak版本需额外授权：flatpak override --user --talk-name=org.freedesktop.Notifications org.qbittorrent.qBittorrent。