Tremotesf

Remote GUI for transmission-daemon. Supports GNU/Linux and Windows.

Table of Contents

• Tremotesf
• Table of Contents
  • Installation
    • Dependencies
    • Building
    • GNU/Linux
    • FreeBSD
    • Windows
    • macOS
  • Translations
  • Screenshots

Installation

Dependencies

• C++ compiler with partial C++23 support. Minimum tested versions of GCC and Clang toolchains:
  1. GCC 14
  2. Clang 19 with libstdc++ 14
  3. Clang 19 with libc++ 19
• CMake 3.25 or newer
• Qt 6.8 or newer (Core, Network, Gui, Widgets modules)
• fmt 10.1.0 or newer
• KWidgetsAddons 6.11 or newer
• libpsl 0.21.2 or newer
• cxxopts 3.2.1 or newer
• Qt Test module (for tests only)
• cpp-httplib 0.18.7 or newer, with OpenSSL support (for tests only, optional)

On GNU/Linux and BSD, also:

• Gettext 0.22.5 or newer
• Qt D-Bus module
• KWindowSystem
• Qt's SVG image format plugin as a runtime dependency (usually located somewhere at /usr/lib64/qt6/plugins/imageformats/libqsvg.so)

On Windows, also:

• Windows 11 SDK is needed to build
• Minimum supported OS version to run Tremotesf is Windows 10 1809 (October 2018 Update)

On macOS, also:

• Latest Xcode and macOS SDK versions supported by Qt (see here)
• Minimum supported OS version to run Tremotesf is macOS 12

Building

cmake -S /path/to/sources -B /path/to/build/directory --preset base-multi
cmake --build /path/to/build/directory --config Debug
cmake --install /path/to/build/directory --config Debug --prefix /path/to/install/directory

This example uses base-multi preset in CMakePresets.json and Ninja Multi-Config generator. You can invoke CMake in a different way if you want.

CMake configuration options:

TREMOTESF_WITH_HTTPLIB - determines how cpp-httplib test dependency is searched. Possible values:

• auto: CMake find_package call, otherwise pkg-config, otherwise bundled copy is used.
• system: CMake find_package call, otherwise pkg-config, otherwise fatal error.
• bundled: bundled copy is used.
• none: cpp-httplib is not used at all and tests that require it are disabled.

GNU/Linux

• Flatpak - Flathub

• Arch Linux - AUR

• Debian - Official repository, or my own OBS repository

debian_version="$(source /etc/os-release && echo "$VERSION_ID")"
wget -qO - "https://download.opensuse.org/repositories/home:/equeim:/tremotesf/Debian_${debian_version}/Release.key" | sudo tee /etc/apt/trusted.gpg.d/tremotesf.asc
sudo add-apt-repository "deb http://download.opensuse.org/repositories/home:/equeim:/tremotesf/Debian_${debian_version}/ /"
sudo apt update
sudo apt install tremotesf

• Fedora - Copr

sudo dnf copr enable equeim/tremotesf
sudo dnf install tremotesf

• Gentoo - equeim-overlay

• openSUSE Tumbleweed - OBS

sudo zypper ar https://download.opensuse.org/repositories/home:/equeim:/tremotesf/openSUSE_Tumbleweed/home:equeim:tremotesf.repo
sudo zypper in tremotesf

• Ubuntu - OBS

ubuntu_version="$(source /etc/os-release && echo "$VERSION_ID")"
wget -qO - "https://download.opensuse.org/repositories/home:/equeim:/tremotesf/xUbuntu_${ubuntu_version}/Release.key" | sudo tee /etc/apt/trusted.gpg.d/tremotesf.asc
sudo add-apt-repository "deb http://download.opensuse.org/repositories/home:/equeim:/tremotesf/xUbuntu_${ubuntu_version}/ /"
sudo apt update
sudo apt install tremotesf

FreeBSD

Tremotesf is available in FreeBSD ports.

Windows

Windows builds are available at releases page. Minimum supported OS version to run Tremotesf is Windows 10 1809 (October 2018 Update).

Build instructions for MSVC toolchain with vcpkg:

1. Install Visual Studio with 'Desktop development with C++' workload
2. Install latest version of CMake (from cmake.org or Visual Studio installer)
3. Install and setup vcpkg, and make sure that you have 15 GB of free space on disk where vcpkg is located
4. Set VCPKG_ROOT environment variable to the location of vcpkg installation

When building from Visual Studio GUI, make sure to select 'Windows Debug' or 'Windows Release' configure preset. Otherwise: Launch x64 Command Prompt for Visual Studio, execute:

cmake -S path\to\sources -B path\to\build\directory --preset <windows-debug or windows-release>
# Initial compilation of dependencies will take a while
cmake --build path\to\build\directory
cmake --install path\to\build\directory --prefix path\to\install\directory
# Next command creates ZIP archive and MSI installer
cmake --build path\to\build\directory --target package

macOS

macOS builds are available at releases page. Minimum supported OS version to run Tremotesf is macOS 12.

Build instructions with vcpkg:

1. Install Xcode
2. Install CMake
3. Install and setup vcpkg, and make sure that you have 15 GB of free space on disk where vcpkg is located
4. Set VCPKG_ROOT environment variable to the location of vcpkg installation
5. Launch terminal, execute:

cmake -S path/to/sources -B path/to/build/directory --preset <macos-arm64-vcpkg or macos-x86_64-vcpkg>
# Initial compilation of dependencies will take a while
cmake --build path/to/build/directory
cmake --install path/to/build/directory --prefix path/to/install/directory
# Next command creates DMG image
cmake --build path/to/build/directory --target package

Translations

Translations are managed on Transifex.

Screenshots