Script Usage

Assumptions

The guide will assume you are using docker, with example commands that are either one liners or from within the container.

Danger

Don’t run this directly on the host system unless you know what you are doing. It’s not recommended and the build will probably fail.

First run - what to expect

⬤ Checking: available privileges ⬤ root ⬤ sudo ⬤ Checking: test ⬤ bash ⬤ curl ⬤ git ⬤ Checking: core ⬤ autoconf ⬤ automake ⬤ build-base ⬤ cmake ⬤ curl ⬤ git ⬤ graphviz ⬤ libtool ⬤ linux-headers ⬤ ninja-build ⬤ ninja-is-really-ninja ⬤ perl ⬤ pkgconf ⬤ py3-numpy ⬤ py3-numpy-dev ⬤ python3 ⬤ python3-dev ⬤ re2c ⬤ ttf-freefont ⬤ xz ⬤ Info: /workspace/qbt-nox-static.bash ⬤ qbt-nox-static.bash install_test ------ installs minimum required tools to run tests ⬤ qbt-nox-static.bash install_core ------ installs required build tools to use script ⬤ qbt-nox-static.bash bootstrap_deps ---- install_test + install_core ⬤ Warning: Missing required test_tools ⬤ Warning: Missing required components of install_core

Test features - what to expect

⬤ Checking: available privileges ⬤ root ⬤ sudo ⬤ Checking: test ⬤ bash ⬤ curl ⬤ git ⬤ Checking: core ⬤ autoconf ⬤ automake ⬤ build-base ⬤ cmake ⬤ graphviz ⬤ libtool ⬤ linux-headers ⬤ ninja-build ⬤ ninja-is-really-ninja ⬤ perl ⬤ pkgconf ⬤ py3-numpy ⬤ py3-numpy-dev ⬤ python3 ⬤ python3-dev ⬤ re2c ⬤ ttf-freefont ⬤ xz ⬤ Info: /workspace/qbt-nox-static.bash ⬤ qbt-nox-static.bash install_core ------ installs required build tools to use script ⬤ qbt-nox-static.bash bootstrap_deps ---- install_test + install_core ⬤ Warning: Missing required components of install_core ⬤ Test URL = passed ⬤ Script version: 2.2.2 ⬤ Below is a list of supported modules: ⬤ all zlib openssl boost libtorrent qtbase qttools qbittorrent ⬤ Default env settings qbt_zlib_type="zlib" qbt_skip_icu="yes" qbt_boost_tag="boost-1.89.0" qbt_libtorrent_version="2.0" qbt_libtorrent_tag="v2.0.11" qbt_libtorrent_master_jamfile="no" qbt_qt_version="6" qbt_qt_tag="v6.9.1" qbt_qbittorrent_tag="release-5.1.2" qbt_build_dir="qbt-build" qbt_build_tool="cmake" qbt_cross_name="default" qbt_mcm_url="userdocs/qbt-musl-cross-make" qbt_patches_url="userdocs/qbittorrent-nox-static" qbt_workflow_files="no" qbt_cache_dir="" qbt_optimise_strip="yes" qbt_build_debug="no" qbt_standard="20" qbt_static_ish="no" qbt_optimise="no" qbt_with_qemu="yes" qbt_host_deps="no" qbt_host_deps_repo="userdocs/qbt-host-deps" qbt_legacy_mode="no" qbt_advanced_view="yes"

Bootstrapped - what to expect

⬤ Checking: available privileges ⬤ root ⬤ sudo ⬤ Checking: test ⬤ bash ⬤ curl ⬤ git ⬤ Checking: core ⬤ autoconf ⬤ automake ⬤ build-base ⬤ cmake ⬤ graphviz ⬤ libtool ⬤ linux-headers ⬤ ninja-build ⬤ ninja-is-really-ninja ⬤ perl ⬤ pkgconf ⬤ py3-numpy ⬤ py3-numpy-dev ⬤ python3 ⬤ python3-dev ⬤ re2c ⬤ ttf-freefont ⬤ xz ⬤ Dependencies: All checks passed, continuing to build ⬤ Test URL = passed ⬤ Script version: 2.2.2 ⬤ Below is a list of supported modules: ⬤ all zlib openssl boost libtorrent qtbase qttools qbittorrent ⬤ Default env settings qbt_zlib_type="zlib" qbt_skip_icu="yes" qbt_boost_tag="boost-1.89.0" qbt_libtorrent_version="2.0" qbt_libtorrent_tag="v2.0.11" qbt_libtorrent_master_jamfile="no" qbt_qt_version="6" qbt_qt_tag="v6.9.1" qbt_qbittorrent_tag="release-5.1.2" qbt_build_dir="qbt-build" qbt_build_tool="cmake" qbt_cross_name="default" qbt_mcm_url="userdocs/qbt-musl-cross-make" qbt_patches_url="userdocs/qbittorrent-nox-static" qbt_workflow_files="no" qbt_cache_dir="" qbt_optimise_strip="yes" qbt_build_debug="no" qbt_standard="20" qbt_static_ish="no" qbt_optimise="no" qbt_with_qemu="yes" qbt_host_deps="no" qbt_host_deps_repo="userdocs/qbt-host-deps" qbt_legacy_mode="no" qbt_advanced_view="yes"

⭐ When you are familiar with the script you can do most builds you want with a one liner. It’s pretty simple to use.

Execute the script

A reminder

If you have a .qbt_env in the same folder as the script it will override any custom env settings you provide.

Using flags will override your .qbt_env

./qbt.bash

Note

Please see the switches and flags summary to see what options you can pass and how to use them

The first thing you should do is to run the script with the -h flag to see the help output and the script defaults.

./qbt.bash -h

By passing all as the first argument, you can build everything based on the default settings.

./qbt.bash all

For example of using custom settings,

• to use ICU using -i
• optimise for the host system CPU using -o to set -march=native
• build using libtorrent v1.2.19

./qbt.bash all -i -o -s -lt v1.2.19

Same as previous command but using env settings

qbt_libtorrent_tag="v1.2.19" qbt_skip_icu="yes" qbt_optimise="yes" ./qbt.bash all

For an older version of qBittorrent, you can specify the version using -qt and the libtorrent version using -lt

./qbt.bash all -q -qt release-4.1.9.1 -lt libtorrent-1_1_14 -bt boost-1.76.0