Skip to content

equeim/tremotesf2

Repository files navigation

Tremotesf

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

Table of Contents

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

wget -qO - https://download.opensuse.org/repositories/home:/equeim:/tremotesf/Debian_12/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_12/ /"
sudo apt update
sudo apt install tremotesf
sudo dnf copr enable equeim/tremotesf
sudo dnf install tremotesf
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
wget -qO - https://download.opensuse.org/repositories/home:/equeim:/tremotesf/xUbuntu_23.10/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_23.10/ /"
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