diff --git a/docs/Building-Transmission.md b/docs/Building-Transmission.md index 64dc5be40..9b118a104 100644 --- a/docs/Building-Transmission.md +++ b/docs/Building-Transmission.md @@ -7,7 +7,7 @@ Software prerequisites: * Xcode 11.3.1 or newer Building the project on Mac requires the source to be retrieved from GitHub. Pre-packaged source code will not compile. -```console +```bash git clone --recurse-submodules https://github.com/transmission/transmission Transmission ``` @@ -21,7 +21,7 @@ Transmission has an Xcode project file for building in Xcode. ### Building the native app with CMake ### Build the app: -```console +```bash cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo cmake --build build -t transmission-mac open ./build/macosx/Transmission.app @@ -29,7 +29,7 @@ open ./build/macosx/Transmission.app ### Building the GTK app with CMake ### Install GTK and build the app: -```console +```bash brew install gtk4 gtkmm4 cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DENABLE_GTK=ON -DENABLE_MAC=OFF cmake --build build -t transmission-gtk @@ -39,20 +39,52 @@ cmake --build build -t transmission-gtk ## On Unix ## ### Prerequisites ### -#### Debian 11 and Newer #### +#### Debian 12 / Bookworm #### +On Debian, you can build transmission with a few dependencies on top of a base installation. + +For building transmission-daemon you will need basic dependencies: +```bash +$ sudo apt install build-essential cmake git libcurl4-openssl-dev libssl-dev +``` +These packages are not mandatory for a working binary. Transmission brings its own libraries if they aren't installed, except for `libsystemd-dev`. +```bash +$ sudo apt install libb64-dev libdeflate-dev libevent-dev libminiupnpc-dev libnatpmp-dev libpsl-dev libsystemd-dev +``` + +You likely want to install transmission as a native GUI application. +There are two options, GTK and Qt. + +GTK 3 client: +```bash +$ sudo apt install gettext libgtkmm-3.0-dev +``` + +Qt5 client: +```bash +$ sudo apt install libqt5svg5-dev qttools5-dev +``` +Qt6 client: +```bash +$ sudo apt install qt6-svg-dev qt6-tools-dev +``` + +Then you can begin [building.](#building-transmission-from-git-first-time) + +#### Debian 11 / Bullseye #### On Debian, you can build transmission with a few dependencies on top of a base installation. For building transmission-daemon you will need basic dependencies ```bash $ sudo apt install git build-essential cmake libcurl4-openssl-dev libssl-dev python3 ``` -You likely want to install transmission as a native GUI application. There are two options, GTK and QT. +You likely want to install transmission as a native GUI application. There are two options, GTK and Qt. For GTK 3 client, two additional packages are required ```bash $ sudo apt install libgtkmm-3.0-dev gettext ``` -For QT client, one additional package is needed on top of basic dependencies + +For Qt client, one additional package is needed on top of basic dependencies ```bash $ sudo apt install qttools5-dev ```