Build Help
Once the script has successfully configured the platform you can execute the help switch to see how it works and what options you have available to you.
Order of preference
The script will use the following order of preference when configuring the build environment:
- Command line flags
.qbt_env
file in the same directory as the script- Exported
env
variables
ENV settings
The script has some env
settings that can trigger certain behaviour without the need to pass flags to the script.
You can export these before you run the script to set them. The can be used for docker builds or local builds and work in the .qbt_env
file.
Build variable | Default if unset | Options | example usage |
---|---|---|---|
qbt_build_dir | qbt-build | Any valid path | qbt_build_dir="~/custom" |
qbt_libtorrent_version | 2.0 | 1.2 2.0 | qbt_libtorrent_version="2.0" |
qbt_qt_version | 6 | 5.12 5.15 6.3 6.3.1 | qbt_qt_version="6" |
qbt_build_tool | cmake | cmake qmake | qbt_build_tool="cmake" |
qbt_cross_name | empty = unset (default to OS gcc) | See Cross arch options below | qbt_cross_name="aarch64" |
qbt_patches_url | username/repo | username/repo | qbt_patches_url="userdocs/qbittorrent-nox-static" |
qbt_skip_icu | yes | yes no | qbt_skip_icu="yes" |
qbt_boost_tag | latest github stable release or tag | Any valid git tag | qbt_boost_tag="boost-1.86.0" |
qbt_libtorrent_tag | latest github stable release or tag | Any valid git tag | qbt_libtorrent_tag="v2.0.10" |
qbt_qt_tag | latest github stable release or tag | Any valid git tag | qbt_qt_tag="v6.8.0" |
qbt_qbittorrent_tag | latest github stable release or tag | Any valid git tag | qbt_qbittorrent_tag="release-5.0.1" |
qbt_libtorrent_master_jamfile | no | yes no | qbt_libtorrent_master_jamfile="no" |
qbt_workflow_files | no | yes no | qbt_workflow_files="no" |
qbt_workflow_artifacts | no | yes no | qbt_workflow_artifacts="no" |
qbt_cache_dir | empty = unset | Path: relative or full | qbt_cache_dir="" |
qbt_optimise_strip | yes | yes no | qbt_optimise_strip="yes" |
qbt_build_debug | no | yes no | qbt_build_debug="no" |
qbt_standard | 20 | 14 17 20 23 | qbt_standard="20" |
qbt_static_ish | no | yes no | qbt_static_ish="no" |
qbt_optimise | no | yes no | qbt_optimise="yes" |
Build flags
The script build is already optimised but if you really want to experiment you can use the following flags in the main env
and they will be appended to the current build flags:
See the _custom_flags
function in the script for more information.
Cross arch options
armel
armhf
armv7
aarch64
x86
x86_64
s390x
powerpc
ppc64el
mips
mipsel
mips64
mips64el
loongarch64
riscv64
Switches and flags summarised
All switches and flags have a supporting help option that will provide dynamic content where applicable.
For example, taking the -h-bs
switch as an example, it will show different results based on the preceding switches provided:
Build - default profile
Install all default modules (ICU is skipped) and build qbittorrent-nox
to the default build directory qbt-build/compelted
.
Build - modules (optional and mostly for debugging and testing)
You can build modules individually, subject to this warning.
Here are the list of supported modules:
Build - paths
By default the script will built to a hard coded path defined by the scripts $install_dir
variable as to avoid installing files to a server and causing conflicts.
You can modify this dynamically with the -b
argument