Skip to content

Rookparcel 1.0.1 (released as PaTorrent)

Choose a tag to compare

@github-actions github-actions released this 27 Oct 10:21
· 534 commits to main since this release

PaTorrent 1.0.1 is the first stable release. It follows 1.0.0-rc.1 with no second candidate: the release candidate ran without trouble, and what changed since is listed below. There is no 1.0.0 release: its tagged build stopped on a packaging check, and the version moved on rather than reuse the tag. 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.0-rc.1

  • A Windows installer beside the portable zip: for you alone (no administrator rights, into %LOCALAPPDATA%\Programs\PaTorrent) or for all users (into Program Files, through UAC), with a Start menu entry, an optional desktop shortcut and .torrent / magnet: associations, in-place upgrades and an uninstaller that keeps your settings unless you ask.
  • An update check that only tells. 10 seconds after the start and every 12 hours, the Windows and GTK GUIs read a small list of releases from the website. A newer version shows for a minute in the status bar and in the Logger; a click opens its release page. Nothing is downloaded or installed for you. Help > Check for Updates asks at once; Preferences > General > Privacy turns the automatic check off. The Flatpak leaves updating to Flathub. 1.0.0-rc.1 has no check, so its users have to fetch this release by hand.
  • The version where µTorrent showed it: the window title, the tray tooltip, the Web UI's tab and the Windows executables' file properties.
  • Help > PaTorrent Website, and the website itself: downloads with how to start each file, an FAQ and the documentation.

Settings and torrents from 1.0.0-rc.1 carry over unchanged.

Downloads

SHA256SUMS has every file's checksum.

Platform File What is inside
Windows 10 / 11, x64, installer patorrent-1.0.1-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.0.1-windows-x64.zip the same two programs; statically linked, nothing to install
Linux desktop, x86_64 or aarch64 PaTorrent-1.0.1-<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.0.1-<arch>.flatpak the GTK 4 GUI on the GNOME 51 runtime (installed from Flathub)
Linux, plain binaries patorrent-1.0.1-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.0.1-<arch>.AppImage patorrent-nox with OpenSSL bundled
macOS, Apple silicon PaTorrent-1.0.1-arm64.dmg PaTorrent.app: the GTK 4 GUI with its libraries bundled (macOS 15 or newer)
macOS, headless patorrent-nox-1.0.1-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". Running a newer setup later 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.0.1-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.0.1-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.

What is in it

  • Engine: downloads and seeds over TCP and uTP, with HTTP, HTTPS and UDP trackers, magnet links, DHT, peer exchange, local peer discovery, protocol encryption, web seeds, SOCKS and HTTP proxies, UPnP / NAT-PMP port mapping, IP filters, super-seeding, sequential download and per-torrent speed limits. BitTorrent v2 and hybrid torrents (BEP 52), including creating them.
  • Windows GUI (patorrent): the µTorrent 2.2.1 main window with its category list, every column, the detail tabs (General, Trackers, Peers, Pieces, Files, Speed, Logger), Preferences, Add New Torrent, Create New Torrent, Torrent Properties, the RSS downloader, the scheduler, Auto Shutdown, the tray icon, file and magnet associations and autostart.
  • GTK 4 GUI (patorrent-gtk, Linux / BSD / macOS): the same main window and dialogs on the shared frontend model, with the tray, notifications, associations and autostart (through the Background portal in a Flatpak).
  • Daemon (patorrent-nox): headless operation, its own Web UI, a qBittorrent-compatible Web API subset so existing tools can talk to it, HTTPS, and service integration (systemd units, a FreeBSD rc.d script, a Windows service).
  • 34 languages, including right-to-left layouts; the translations are machine-made and unreviewed, so corrections are welcome.
  • Scale: on the author's PC the Windows GUI lists 100,000 torrents in about a second with idle GUI CPU under 0.1 %.

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 installer is new: every build installs, checks and uninstalls it silently, but its wizard and the all-users path have had little hand testing.
  • macOS: the .app has only been built and started on GitHub's runners; it has not been used on a real Mac. Window content, opening files and magnets from Finder, Login Items and the menu-bar icon are unverified.
  • The Linux AppImages and the Flatpak have had command-line smoke checks but little desktop use; the aarch64 builds are untried on real hardware.
  • The 100,000-torrent target has been measured on one mid-range PC only.

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.

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.