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++20 support. Minimum tested versions of GCC and Clang toolchains:
  1. GCC 12
  2. Clang 17 with libstdc++ 13
  3. Clang 17 with libc++ 17
• CMake 3.25 or newer
• Qt 6.6 or newer or 5.15 (Core, Network, Gui, Widgets modules)
• fmt 9.1 or newer
• KWidgetsAddons 5.103 or newer
• libpsl 0.21.2 or newer
• cxxopts 3.1.1 or newer
• Qt Test module (for tests only)
• OpenSSL 1.1.1 or newer (for tests only)
• cpp-httplib 0.11.0 or newer (for tests only, optional)

On GNU/Linux and BSD, also:

• Gettext 0.21 or newer
• Qt D-Bus module
• KWindowSystem (with Qt5/KF5 kwayland-integration is also needed as runtime dependency)
• 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_QT6 - boolean, determines whether Qt 6 or Qt 5 will be used.

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

• Mageia - Copr

  sudo dnf copr enable equeim/tremotesf
  sudo dnf install tremotesf

• 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