- zlib >= 1.2.11
- Qt 6.5.0 - 6.5.5
- Despite building headless application, the QT library should be installed
- CMake >= 3.16
- Boost >= 1.76
- libtorrent-rasterbar >= 1.2.19
- Python >= 3.7.0
-
Install dependencies
brew install python3 qt zlib boost libtorrent-rasterbar cmake
- Please note that the suggested installation command would work for modern ARM-based platforms (M1+). If you are still using Intel Macs to run Qbt, please stick with the QT version 6.5.5, do not update it with
brew
- Here's some steps to install QT 6.5.5 from source:
- download source files from https://qt.mirror.constant.com
curl -O https://qt.mirror.constant.com/archive/qt/6.5/6.5.5/src/single/qt-everywhere-opensource-src-6.5.5.tar.xz
- unarchive
tar xvf qt-everywhere-opensource-src-6.5.5.tar.xz cd qt-everywhere-opensource-src-6.5.5
- use these build instructions: https://doc.qt.io/qt-6/macos-building.html
- download source files from https://qt.mirror.constant.com
- Please note that the suggested installation command would work for modern ARM-based platforms (M1+). If you are still using Intel Macs to run Qbt, please stick with the QT version 6.5.5, do not update it with
-
Run setup for building headless (webUI only) application.
cmake -B build -DCMAKE_BUILD_TYPE=Release -DGUI=OFF
If you want to install 4.6 version instead of v5+, the explicit QT6 option should be provided
cmake -B build -DCMAKE_BUILD_TYPE=Release -DGUI=OFF -DQT6=ON
- Build
cmake --build build
- Install, optionally provide installation (prefix) path.
cmake --install build --prefix $HOME/bin
- Create a symlink to the executable:
cd $HOME/bin/qbittorrent-nox.app/Contents/MacOS/
ln -s $PWD/qbittorrent-nox /usr/local/bin/qbittorrent-nox
- Create autostart plist:
cd ~/Library/LaunchAgents/
vim com.qbittorrent-nox.plist
add plist conntents:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key>
<true/>
<key>Label</key>
<string>com.qbittorrent-nox</string>
<key>LimitLoadToSessionType</key>
<array>
<string>Aqua</string>
<string>Background</string>
<string>LoginWindow</string>
<string>StandardIO</string>
<string>System</string>
</array>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/qbittorrent-nox</string>
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
- Start the autostart:
launchctl bootstrap gui/501 $HOME/Library/LaunchAgents/com.qbittorrent-nox.plist