Skip to content

Rookparcel 1.1.0 (released as PaTorrent)

Choose a tag to compare

@github-actions github-actions released this 28 Oct 13:42
· 470 commits to main since this release

PaTorrent 1.1.0 adds a search box and importers from qBittorrent and µTorrent, hardens the engine, the Web UI and the remote mode after a security review of the whole code base, fixes what the author's hand test of 1.0.1 on Windows found, and puts icons beside the category list, the detail tabs, the Preferences pages and the Windows menus. It has been used mostly by its author so far, so reports of what breaks are very welcome.

PaTorrent (PatinaTorrent) is a lean BitTorrent client in the spirit of µTorrent 2.2.1: small single-file binaries, a native look, low RAM and CPU use, and an interface that stays responsive with tens of thousands of torrents. The engine is our own Rust port of libtorrent-rasterbar 2.0.11; nothing is linked.

New since 1.0.1

  • Search box. Where µTorrent 2.2.1 had its web search, the toolbar now has a box that filters the torrent list by name as you type, on top of the category or label picked on the left. Ctrl+F jumps to it.
  • Import from qBittorrent and µTorrent. File > Import reads qBittorrent's BT_backup folder or µTorrent's resume.dat and adds those torrents with their save folders, labels and settings. The other client must not be running; nothing of it is changed. The files are checked again after the import, rather than trusting the old client's records, and every file stays inside its save folder: the question before the import lists those folders. patorrent-nox run --import does the same for the daemon.
  • Security hardening. A review of the engine, the Web UI, the remote mode, fetches and the Windows integration led to fixes across them. Among them: peers that never read, degenerate encryption keys and unbounded web-seed headers can no longer tie the client up; the DHT ignores replies from addresses it did not ask and refuses to be pointed at loopback or the LAN; trackers elsewhere cannot list peers on your machine, and no peer connections go to ports below 1024; seed mode checks each piece before uploading it; HTTPS needs TLS 1.2 and refuses revoked certificates; feeds and redirects cannot reach your local network unless you added that address yourself; cookies stay on their site; the Web UI bounds connections before login, bans per client, ends other sessions when the password changes and asks for the current password before its security settings change; random numbers come from a ChaCha20 generator seeded by the operating system, with no weak fallback.
  • Remote mode over HTTPS. The GUIs connect to a patorrent-nox over HTTPS by default; plain HTTP to another computer needs your agreement first.
  • Windows fixes. Stopped torrents no longer show their last speed; rows no longer go blank after hovering or Select All; the scheduler grid no longer flickers and uses µTorrent's colours; alternating row shading (Preferences > UI Settings, on by default); Ctrl+S, Ctrl+T, Ctrl+Shift+P and Enter for Start, Stop, Pause and Properties, shown in the menus; redrawn toolbar icons and a magnifier for the checking states.
  • Icons beside the category list, the detail tabs and the Preferences pages (Windows and GTK), and beside the Windows menu commands.
  • Version strings. A build that is not a tagged release shows <version>-dev.<commit> in its title bar, About box and --version, so test builds can be told apart.

Settings and torrents from 1.0.1 carry over unchanged.

The remote protocol changed (version 9). A GUI and a patorrent-nox must both be 1.1.0 to work together in the remote mode; update both.

The peer ID is now -PA1011- (it was -PA1010-): the engine's behaviour on the wire changed with the fixes above.

Downloads

SHA256SUMS has every file's checksum.

Platform File What is inside
Windows 10 / 11, x64, installer patorrent-1.1.0-windows-x64-setup.exe patorrent.exe (the GUI) and patorrent-nox.exe (the headless daemon), installed with a Start menu entry and an uninstaller
Windows 10 / 11, x64, portable patorrent-1.1.0-windows-x64.zip the same two programs; statically linked, nothing to install
Linux desktop, x86_64 or aarch64 PaTorrent-1.1.0-<arch>.AppImage the GTK 4 GUI with its libraries bundled (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13 or later)
Linux desktop, Flatpak PaTorrent-1.1.0-<arch>.flatpak the GTK 4 GUI on the GNOME 51 runtime (installed from Flathub)
Linux, plain binaries patorrent-1.1.0-linux-<arch>.tar.gz patorrent-gtk, patorrent-nox, the desktop entry and the systemd units; they use the system's GTK 4 (4.12 or newer) and OpenSSL 3, as on Ubuntu 24.04
Linux server, headless patorrent-nox-1.1.0-<arch>.AppImage patorrent-nox with OpenSSL bundled
macOS, Apple silicon PaTorrent-1.1.0-arm64.dmg PaTorrent.app: the GTK 4 GUI with its libraries bundled (macOS 15 or newer)
macOS, headless patorrent-nox-1.1.0-macos-<arch>.tar.gz patorrent-nox for Apple silicon (arm64, macOS 11+) and Intel (x86_64, macOS 10.14+)

First run

  • Windows installer. Run the setup. It is not code-signed, so SmartScreen shows "Windows protected your PC": More info > Run anyway. "Install for anyone using this computer" asks for administrator rights and shows "Unknown publisher". Over an installed 1.0.1 it upgrades in place. Settings and torrents are in %APPDATA%\PaTorrent.

  • Windows zip. Unzip anywhere and start patorrent.exe (SmartScreen as above). Settings and torrents go to %APPDATA%\PaTorrent; an empty patorrent.ini next to the exe keeps them beside it instead (portable mode).

  • Linux AppImage. chmod +x PaTorrent-1.1.0-x86_64.AppImage, then run it. Without FUSE 2 on the system, start it with --appimage-extract-and-run. Settings are in ~/.config/patorrent/gtk, torrents in ~/.local/share/patorrent/gtk.

  • Linux Flatpak. The bundle holds the application; the runtime comes from Flathub:

    flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo
    flatpak install --user PaTorrent-1.1.0-x86_64.flatpak
    flatpak run io.github.balls0fsteel.PaTorrent
  • macOS. Drag PaTorrent.app to Applications. It is ad-hoc signed and not notarised, so Gatekeeper refuses it the first time ("cannot be opened because the developer cannot be verified"): right-click (or Control-click) the app > Open, then Open. Or remove the quarantine flag: xattr -dr com.apple.quarantine /Applications/PaTorrent.app. The GUI is Apple silicon only; Intel Macs get patorrent-nox.

  • Headless. patorrent-nox run --webui 8080 --webui-pass PASS starts the daemon with its Web UI and a qBittorrent-compatible Web API on port 8080 (--webui-https for a self-signed certificate). patorrent-nox add file.torrent --save DIR adds a torrent. Running it as a service (systemd units, FreeBSD rc.d, --daemon, a Windows service) is described in docs/DAEMON.md.

  • Remote control. Either GUI can drive a patorrent-nox elsewhere: File > Connect to Remote..., or start it with --remote. Both sides must be 1.1.0.

Known limitations

  • Most features have been exercised by the author only; some dialogs and settings have had little use. Keep a copy of torrents you care about elsewhere.
  • Do not use it on private trackers yet. The client ID PA is not whitelisted anywhere.
  • Nothing is code-signed: Windows SmartScreen and macOS Gatekeeper warn (see above).
  • The search box and the importers are new and have had little hand testing; the importers have been tested against qBittorrent's and µTorrent's file formats, not yet against many real installations.
  • The GTK GUI's new icons have been built and checked on CI but not yet looked at on a Linux desktop.
  • macOS: the .app has only been built and started on GitHub's runners; it has not been used on a real Mac.
  • The Linux AppImages and the Flatpak have had command-line smoke checks but little desktop use; the aarch64 builds are untried on real hardware.

Reporting problems

Open an issue with your platform, the file you used and what happened. For a crash or a stuck torrent, the Logger tab or patorrent-nox run --verbose output helps. Security problems: see SECURITY.md.

License

PaTorrent is free for noncommercial use under the PolyForm Noncommercial License 1.0.0. Code ported from libtorrent remains under its BSD-3-Clause license; every download carries LICENSE.md and THIRD-PARTY-NOTICES.md. PaTorrent is an independent project, not affiliated with libtorrent, qBittorrent, µTorrent or BitTorrent, Inc.