示例和用法

在 Unix 上更新保存路径

在这里，种子文件保存在 ~/torrents/some/old/path/here。运行以下命令将导致保存路径变为 ~/torrents/new/thing/here。

qbfrt -v --old-path /some/old/path --new-path /new/thing

在 Windows 上更新保存路径

在这里，种子文件保存在 D:\Downloads\torrents\some\old\path\here。运行以下命令将导致保存路径变为 C:\torrents\some\old\path\here。

.\qbfrt -v --old-path "D:\Downloads" --new-path "C:\"

强制使用特定路径分隔符

您可以通过传递 --use-unix-sep 或 --use-win-sep 来强制更新路径使用特定分隔符。如果您想更新不同机器上的保存路径，这很有用。在这里，种子文件在一个 Windows 机器上保存为 D:\Downloads\some\folder，我们正在 Linux 上运行命令。新路径仍然使用 Windows "" 路径分隔符。注意，您需要在 bash 中转义反斜杠。

qbfrt -v --old-path "D:\\Downloads" --new-path "C:\\" --use-win-sep

更新跟踪器 URL

这里的种子文件有以下跟踪器

• http://some.tracker:6969/tracker
• http://other.tracker:6969/tracker

运行以下命令将导致跟踪器变为

• http://some.tracker:6969/tracker
• http://beans.tracker:6969/tracker

qbfrt -v --old-tracker other --new-tracker beans

注意

• 默认情况下，在处理更改之前将创建 torrents.db 文件的带时间戳的备份。目前，使用简单的文件复制来执行备份，而不是正确的 SQL 导出。在运行此工具之前，请确保 qBittorrent 已完全关闭。
• 保存路径替换使用懒查找和替换。它将替换所有旧字符串的实例。如果您正在更新可能与他人共享段的部分路径，请小心。例如，--existing-path /torrents/movie 将匹配 /torrents/movies 和 /torrents/movie-folder。避免使用单个单词，因为它将替换其所有实例。
• 与保存路径一样，跟踪器替换也使用懒查找和替换。它将替换所有旧字符串的实例。
• 如果您在字符串末尾添加一个斜杠，请注意在新字符串末尾也包含一个斜杠，否则它将删除它。
• 您必须为每个要更改的路径运行一次命令，目前您不能批量处理不同的路径替换。
• 使用类似 Beekeeper Studio 的工具来确认已做出适当的更改。检查 target_save_path 列。您可以检查 libtorrent_resume_data 保存路径和跟踪器列表，但首先您必须将十六进制数据块转换为文本。
• Windows 的 Git bash/MINGW64：mingw 会搞乱以 "/" 开头的部分路径，使其相对于本地 git 程序目录。请参阅 这里。请使用命令提示符或 PowerShell 运行命令。

从源代码构建

在我弄清楚如何编译跨平台之前，您将不得不自己完成。

1. 安装 Rust

2. 克隆 git 仓库

git clone https://github.com/strangeepoxy/qbfrt.git

3. 编译应用程序

cargo build --release

4. 将编译的执行文件移动到您想要的位置

Unix

mv /target/release/qbfrt /place/you/want/qbfrt

Windows

move ./target/release/qbfrt.exe C:/place/you/want/qbfrt.exe

5. （可选）将 qbfrt 添加到您的路径

从源代码更新

1. 从仓库拉取更新

git pull

2. 从步骤 3 开始，遵循“从源代码构建”。