Axeia/qBittorrentCompanion
GitHub: Axeia/qBittorrentCompanion
QBC 是 qBittorrent 的功能增强型桌面客户端，解决了 WebUI 操作不便和功能缺失的问题。
Stars: 29 | Forks: 1
# qBittorrent Companion (QBC)
## QBC 是什么？
qBittorrent Companion (QBC) 是 qBittorrent 的伴侣应用程序。没有一个网络可达的 qBittorrent '主机'，它将无法工作。
可以将其视为 WebUI 的替代品，但它是一个独立的应用程序，而非网页。
## 功能特性
QBC 应该能够完成您在 WebUI 中所能做的一切。不过，QBC 致力于功能对标 qBittorrent 本身，并恢复了您可能发现 WebUI 所缺少的这些功能：
* 监控 `.torrent` 文件所在目录
* 支持拖放 `.torrent` 文件
* 多标签页搜索，支持同时查询
* 快捷键导航
* 支持明暗主题模式
* 实时预览 RSS 规则结果
* 编辑种子追踪器（尽管由于 API 限制[^1] 存在一些限制）
* 下载和上传速度的实时折线图
* QBC '最小化'到系统托盘（当然也可以从那里选择彻底关闭）
* 系统级通知（或应用内通知，取决于您的偏好），并对通知的使用进行精细控制
*如果您缺少 qBittorrent 或 WebUI 中存在的某个功能，请在 GitHub 上创建一个 issue，我会尽力而为。*
### 独有功能
但这还不是全部！ QBC 拥有一些甚至在 qBittorrent 本身中也找不到的功能：
* 通过基于插件的系统，从文件/种子名称生成 RSS 规则[^2]
* 支持在 RSS 规则中测试数据（当目标内容当前不在订阅源中时很有用）
* 内置搜索插件管理器
* 搜索插件来源于 [qBittorrent wiki](https://github.com/qbittorrent/search-plugins/wiki/Unofficial-search-plugins)，并以可一键安装的方式呈现
* 搜索插件可以选择 '本地安装'。QBC 使用与 qBittorrent 相同的插件系统，因此结果应该相同，只是由于不再通过 qBittorrent 中转，速度会快得多。
*本地搜索需要安装 Python* * 根据某些属性筛选种子，而无需牺牲空间给侧边栏（侧边栏仍然是默认选项） * 一个通过点击按钮访问的下拉菜单，提供与侧边栏相同的筛选选项 * 用于 RSS 规则中正则表达式的语法高亮显示 * 可以暂停对等点更新（防止它们跳动导致选择错误） * 可自定义的应用程序图标（设置颜色以匹配您的环境或增加对比度） <详情> <摘要>关于使用本地搜索插件的警告： 由于本地搜索**没有**通过 qBittorrent 进行中转，搜索数据和搜索结果数据会在您的 QBC 设备和搜索插件网站之间传输。
这可能产生法律影响，特别是当您的 QBC 和 qBittorrent 设备位于不同地区或国家时。 [^1]: 由于 WebUI 的限制，如果编辑了任何内容，所有追踪器将被放置在同一个层级。 [^2]: RSS 插件支持：从种子名称自动创建 RSS 规则，可在应用程序内任何地方使用。也支持手动输入。 ## 安装说明 **简短版：** 下载[可执行文件](https://github.com/Axeia/qBittorrentCompanion/releases/)，解压它，*运行它。
**详细版：** 1. 在您的 '服务器' 电脑上安装 qBittorrent。qBittorrent Companion 需要登录到 qBittorrent WebUI。 2. 设置 qBittorrent 并启用 WebUI。在服务器上访问 http://127.0.0.1:8080 进行测试（默认端口是 `8080`；如果您更改了端口，请调整 URL）。 如果可以访问，请尝试从您打算运行 qBittorrent Companion 的设备访问 http://your.server.ip.address:8080。 3. 下载 qBittorrent Companion 的最新[版本](https://github.com/Axeia/qBittorrentCompanion/releases/)。 * 对于 Windows 用户，选项有： * 使用 .exe 安装程序，然后直接启动它 *（启动时您需要点击 `更多信息 > 仍要运行`）* * 或者解压 win-x64.zip 并运行 qBittorrentCompanion.Desktop.exe 作为'独立'版本。 * 对于 Linux 用户 * 解压 linux-x64.tar.gz 文件并运行 qBittorrentCompanion.Desktop 4. 运行它，如果在操作步骤上有任何问题，请按照登录窗口帮助选项卡中的说明进行操作。 **这些额外的步骤是因为 QBC 没有 '签名'。我可能会考虑在未来通过 [signpath.org](https://signpath.org/) 来完成签名。* ## 已知问题 / 限制 * **`传输` 选项卡**
`内容`（子）选项卡存在一些渲染故障，仅当内容足够多以至于出现垂直滚动条时才会发生。尺寸计算存在问题，列宽可能会跳动。我认为这无法由我修复，而是需要 Avalonia 的 TreeDataGrid 进行更新。 * **`RSS 规则` 选项卡**
结果预览方式与 qBittorrent 不同。这可能导致结果不一致，尽管我目前还未遇到。（QBC 使用 C# 的正则表达式实现，qBittorrent 使用 PERL） * **偏好设置窗口**
测试很少，我个人优先级非常低。我预期它的功能不佳多于良好。欢迎就此提交错误报告，我会进行修复。 * **RSS 订阅源**
在详情面板中显示的描述使用 HTML 格式。为了尽可能安全，我选择仅支持 HTML 的一个子集。 如果这导致您的问题，请在 GitHub 上创建一个 issue，并附上 RSS Feed 的链接。 ## 计划功能 * 支持 Android 操作系统 * 支持使用 Winget 管理更新/安装 ## 开发者指南 以下内容主要面向对某些设计决策感兴趣的开发者，而非普通用户（除非您非常好奇）。 ## 构建命令 目前仅支持 Windows 和 Linux - 但 Android 支持可能会在未来某个时候添加。
iOS/Mac 用户可能运气不佳。该技术栈支持它，但 Apple 对非其设备开发者设置了很高的门槛。
*如果有人愿意捐赠 MacBook 或 Mac Mini，我会尽力而为 ;)* -- **Windows 开发者：** 建议您使用项目内的 release.ps1 PowerShell 脚本，而不是自己运行命令。 它将： * 运行下面列出的两条命令 * 创建 Velopack 安装程序（以及更新功能所需的文件） * 设置 Linux 可执行文件权限 * 清理未使用的文件 * 打包成 .zip / .tar.gz 文件 * 打开包含待发布文件的文件夹 如果我将来在 Linux 下开发 QBC，我会编写一个 bash 对应脚本，但在撰写本文时尚不存在。 ### Windows 窗口
``` dotnet publish ./qBittorrentCompanion.Desktop/qBittorrentCompanion.Desktop.csproj -c Release -r win-x64 -f net8.0-windows --self-contained ``` ### Linux 企鹅
``` dotnet publish ./qBittorrentCompanion.Desktop/qBittorrentCompanion.Desktop.csproj -c Release -r linux-x64 -f net8.0 --self-contained ```
## 许可证 * 本项目由 Pascal Bakhuis 基于 MIT 许可证发布 * nova3 文件夹及其内容是唯一的例外，它基于 GPLv3 许可证（除非文件本身另有说明），因为它来自 qBittorrent 项目（未作任何修改） ## 致谢 * qBittorrent Companion: Pascal Bakhuis * qBittorrent.Client: [Pavel Fedarovich](https://github.com/fedarovich/qBittorrent-net-client) * UI: [Avalonia](https://avaloniaui.net/) (以及 [fluent icons](https://github.com/davidxuang/FluentIcons)) * 国旗图标: [flagpedia.net](https://flagpedia.net/) (在 `对等点` 选项卡中选择种子时显示) * JSON: [Newtonsoft's JSON.net](https://www.newtonsoft.com/json) (用于[重新]加载设置和一些 JSON 任务) * Windows 安装程序/更新程序: [Velopack](https://velopack.io/) (没有专用安装程序的版本使用我自己的代码进行更新) 当然，还有 [qBittorrent(.org)](https://www.qBittorrent.org/) 本身。
*本地搜索需要安装 Python* * 根据某些属性筛选种子，而无需牺牲空间给侧边栏（侧边栏仍然是默认选项） * 一个通过点击按钮访问的下拉菜单，提供与侧边栏相同的筛选选项 * 用于 RSS 规则中正则表达式的语法高亮显示 * 可以暂停对等点更新（防止它们跳动导致选择错误） * 可自定义的应用程序图标（设置颜色以匹配您的环境或增加对比度） <详情> <摘要>关于使用本地搜索插件的警告： 由于本地搜索**没有**通过 qBittorrent 进行中转，搜索数据和搜索结果数据会在您的 QBC 设备和搜索插件网站之间传输。
这可能产生法律影响，特别是当您的 QBC 和 qBittorrent 设备位于不同地区或国家时。 [^1]: 由于 WebUI 的限制，如果编辑了任何内容，所有追踪器将被放置在同一个层级。 [^2]: RSS 插件支持：从种子名称自动创建 RSS 规则，可在应用程序内任何地方使用。也支持手动输入。 ## 安装说明 **简短版：** 下载[可执行文件](https://github.com/Axeia/qBittorrentCompanion/releases/)，解压它，*运行它。
**详细版：** 1. 在您的 '服务器' 电脑上安装 qBittorrent。qBittorrent Companion 需要登录到 qBittorrent WebUI。 2. 设置 qBittorrent 并启用 WebUI。在服务器上访问 http://127.0.0.1:8080 进行测试（默认端口是 `8080`；如果您更改了端口，请调整 URL）。 如果可以访问，请尝试从您打算运行 qBittorrent Companion 的设备访问 http://your.server.ip.address:8080。 3. 下载 qBittorrent Companion 的最新[版本](https://github.com/Axeia/qBittorrentCompanion/releases/)。 * 对于 Windows 用户，选项有： * 使用 .exe 安装程序，然后直接启动它 *（启动时您需要点击 `更多信息 > 仍要运行`）* * 或者解压 win-x64.zip 并运行 qBittorrentCompanion.Desktop.exe 作为'独立'版本。 * 对于 Linux 用户 * 解压 linux-x64.tar.gz 文件并运行 qBittorrentCompanion.Desktop 4. 运行它，如果在操作步骤上有任何问题，请按照登录窗口帮助选项卡中的说明进行操作。 **这些额外的步骤是因为 QBC 没有 '签名'。我可能会考虑在未来通过 [signpath.org](https://signpath.org/) 来完成签名。* ## 已知问题 / 限制 * **`传输` 选项卡**
`内容`（子）选项卡存在一些渲染故障，仅当内容足够多以至于出现垂直滚动条时才会发生。尺寸计算存在问题，列宽可能会跳动。我认为这无法由我修复，而是需要 Avalonia 的 TreeDataGrid 进行更新。 * **`RSS 规则` 选项卡**
结果预览方式与 qBittorrent 不同。这可能导致结果不一致，尽管我目前还未遇到。（QBC 使用 C# 的正则表达式实现，qBittorrent 使用 PERL） * **偏好设置窗口**
测试很少，我个人优先级非常低。我预期它的功能不佳多于良好。欢迎就此提交错误报告，我会进行修复。 * **RSS 订阅源**
在详情面板中显示的描述使用 HTML 格式。为了尽可能安全，我选择仅支持 HTML 的一个子集。 如果这导致您的问题，请在 GitHub 上创建一个 issue，并附上 RSS Feed 的链接。 ## 计划功能 * 支持 Android 操作系统 * 支持使用 Winget 管理更新/安装 ## 开发者指南 以下内容主要面向对某些设计决策感兴趣的开发者，而非普通用户（除非您非常好奇）。 ## 构建命令 目前仅支持 Windows 和 Linux - 但 Android 支持可能会在未来某个时候添加。
iOS/Mac 用户可能运气不佳。该技术栈支持它，但 Apple 对非其设备开发者设置了很高的门槛。
*如果有人愿意捐赠 MacBook 或 Mac Mini，我会尽力而为 ;)* -- **Windows 开发者：** 建议您使用项目内的 release.ps1 PowerShell 脚本，而不是自己运行命令。 它将： * 运行下面列出的两条命令 * 创建 Velopack 安装程序（以及更新功能所需的文件） * 设置 Linux 可执行文件权限 * 清理未使用的文件 * 打包成 .zip / .tar.gz 文件 * 打开包含待发布文件的文件夹 如果我将来在 Linux 下开发 QBC，我会编写一个 bash 对应脚本，但在撰写本文时尚不存在。 ### Windows 窗口
``` dotnet publish ./qBittorrentCompanion.Desktop/qBittorrentCompanion.Desktop.csproj -c Release -r win-x64 -f net8.0-windows --self-contained ``` ### Linux 企鹅
``` dotnet publish ./qBittorrentCompanion.Desktop/qBittorrentCompanion.Desktop.csproj -c Release -r linux-x64 -f net8.0 --self-contained ```
## 许可证 * 本项目由 Pascal Bakhuis 基于 MIT 许可证发布 * nova3 文件夹及其内容是唯一的例外，它基于 GPLv3 许可证（除非文件本身另有说明），因为它来自 qBittorrent 项目（未作任何修改） ## 致谢 * qBittorrent Companion: Pascal Bakhuis * qBittorrent.Client: [Pavel Fedarovich](https://github.com/fedarovich/qBittorrent-net-client) * UI: [Avalonia](https://avaloniaui.net/) (以及 [fluent icons](https://github.com/davidxuang/FluentIcons)) * 国旗图标: [flagpedia.net](https://flagpedia.net/) (在 `对等点` 选项卡中选择种子时显示) * JSON: [Newtonsoft's JSON.net](https://www.newtonsoft.com/json) (用于[重新]加载设置和一些 JSON 任务) * Windows 安装程序/更新程序: [Velopack](https://velopack.io/) (没有专用安装程序的版本使用我自己的代码进行更新) 当然，还有 [qBittorrent(.org)](https://www.qBittorrent.org/) 本身。
标签：BT下载管理, Linux客户端, qBittorrent伴侣应用, RSS订阅管理, torrent客户端, WebUI替代品, Windows客户端, 下载工具, 多人体追踪, 多标签搜索, 实时网速图表, 应用通知, 快捷键导航, 拖拽支持, 插件扩展, 搜索插件管理, 文件夹监控, 文件监控, 暗黑模式, 桌面软件, 系统托盘图标, 网络工具, 跨平台应用程序, 远程控制客户端, 逆向工具