Setup Advanced PlatformAgnostic - fedarovich/qbittorrent-cli GitHub Wiki

Platform-agnostic packages

There are two kinds of platform-agnostic packages: built for .Net Core 2.x/3.x/6 runtime and built for .Net Framework 4.6 (or mono 5.4). Using qBittorrent CLI from these packages requires the corresponding runtime to be installed.

Package Required Runtime
qbt-netcore21-version.zip
qbt-netcore21-version.tar.gz		 .Net Core 2.1 or later
qbt-netcore31-version.zip
qbt-netcore31-version.tar.gz		 .Net Core 3.1 or later
qbt-net6-version.zip
qbt-net6-version.tar.gz		 .Net 6 or later
qbt-netfx46-version.zip
qbt-netfx46-version.tar.gz		 On Windows: .Net Framework 4.6 or later (included in Windows 10, available as a separate download for Windows Vista SP2 or later.)
On Linux & Mac OS X: mono 5.4 or later

On Windows platforms it is easier to use the package for .Net framework 4.6 runtime, as it is preinstalled on Windows 10 and is likely installed on older Windows versions if you have Windows Update enabled. If you don't have it though you can download it from Microsoft website.

On Linux and Mac OS X platforms it is recommended to use a package for .Net Core 3.x runtime as it is considered to be more stable, fast and lightweight. On the other hand, if you have an old or x86 (32-bit) OS, which is not supported by .Net Core 2.x runtime, you can use a package for .Net framework 4.6 and run it using mono 5.4 or later.

The minimal required OS version is summarized in the following table:

Runtime Windows (x86) Windows (x64) Linux (x86) 1 Linux (x64) 1 Linux (ARM) 1 Mac OS X
.Net Core 2.x 7 SP1 7 SP1 not supported Ubuntu 14.04
Debian 8.7
CentOS 7
Fedora 26
openSUSE 42.3		 Armbian (Ubuntu 16.04)
Armbian (Debian 9)
Raspbian 9		 10.12
.Net Core 3.x 7 SP1 7 SP1 not supported Ubuntu 16.04
Debian 9
CentOS 7
Fedora 31
openSUSE 15
Alpine 3.12		 Armbian (Ubuntu 16.04)
Armbian (Debian 9)
Raspbian 9
Alpine 3.12 (ARM64)		 10.13
.Net 6 7 SP1 7 SP1 not supported Ubuntu 16.04
Debian 10
CentOS 7
Fedora 33
openSUSE 15
Alpine 3.12		 Armbian (Ubuntu 16.04)
Armbian (Debian 10)
Raspbian 10
Alpine 3.13 (ARM)
Alpine 3.12 (ARM64)		 10.15
.Net Framework 4.6 Vista SP2 Vista SP2 not supported not supported not supported not supported
mono 5.4 7 SP1 2 7 SP1 2 Ubuntu 12.04
Debian 7
CentOS 6		 Ubuntu 12.04
Debian 7
CentOS 6
Fedora 27		 Armbian (Debian 8)
Raspbian 8		 10.7

[1] Only some of the supported Linux distributions are listed here.

[2] It is not recommended to use mono on Windows. Use .Net Framework instead.

Installation

The platform-agnostics packages are provided in the form of plain *.zip or *.tar.gz archives containing the application binaries. So the steps to install the package are the following:

  1. Install the corresponding runtime (.Net Core, .Net Framework or mono) if you have not done it yet.
  2. Create a new folder where the application files will be placed.
  3. Download the archive and extract it to the created folder.
  4. (Optional) If you want to run qbt from any folder:
    • either add the application folder to the PATH environmental variable;
    • or (Linux and Mac OS only) create a symbolic link to the file qbt in /usr/local/bin or in any other folder which is in the PATH.

Getting started with qBittorrent CLI:

Run the following command:

qbt --help
⚠️ **GitHub.com Fallback** ⚠️