Home

Awesome

Transmission Remote GUI

Build Status

Screenshot

<!-- START doctoc generated TOC please keep comment here to allow auto update --> <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

Table of Contents

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

Introduction

Transmission Remote GUI is feature rich cross platform front-end to remotely control Transmission daemon via its RPC protocol. It is faster and has more functionality than builtin Transmission web interface.

Transmission Remote GUI is developed using Lazarus RAD and Free Pascal compiler.

Features:

Installation

The installers are listed on the GitHub Releases page, and the installation instructions for different platform are listed as below :arrow_down:

Linux

Easy way (recommended)

There are precompiled program's binaries for i386 and x86_64 Linux architectures.

Now you can execute the transgui binary. (Change the transgui file permissions to executable if needed)

Additionally, you can create a desktop or menu shortcut to the transgui executable, and run the program using the created shortcut.

Harder way

Build the program by yourself.

  1. Make sure you have working Lazarus and Free Pascal compiler installed.
  1. Download the sources archive and extract it to some folder or perform svn checkout.
  2. Open terminal/command line prompt and cd to the sources folder.
  3. Execute lazbuild -B "transgui.lpi" --lazarusdir=/usr/lib/lazarus/default/ command to build the transgui.res file.
  4. Execute make command to build the application.
  5. Execute make zipdist command to create a release .zip archive in the Release sub-folder.

Windows

Portable zip tarball (recommended)

Note: The first time you use this program, you may need to install some additional dependencies (if you need SSL/TLS enabled), including Visual C++ Redistributable Package(Direct link) and OpenSSL libs(Direct link), this only needs to be done once.

Installer

This installer has additional installation wizard and includes static OpenSSL libraries in every releases, the size would be much bigger than the zip tarball, but you don't need to take care of the OpenSSL dependencies.

  1. Directly download the installer.
  2. Run the installer and follow the steps to install it on your system.

Using Chocolatey

Run choco install transgui to install the latest version of Transmission Remote GUI.

macOS

Without a package manager

This method needs no additional pre-requirement or dependency, just:

  1. Download the app image from release page.
  2. Open the image file to mount the image.
  3. Directly run the application or drag the app icon to your disk / Application folder.

Homebrew

You need to have Homebrew installed. Execute this command to install Transmission Remote Gui:

Command line parameters

You can specify path to a .torrent file or a magnet link as a command line parameter. The program will add the specified torrent.

Portable mode

If the program finds the transgui.ini file in the same folder as the binary file, then it will store all configuration and data files in the program's folder, instead of the folder in a user profile.

Fixed hotkeys

Advanced parameters

There are some parameters in the transgui.ini file, that can not be modified via the GUI. More info on: #924 (File Manager & Shortcuts) , #1020 (User Defined Menu Windows Only) and #1070 (.torrent Auto Opening)

[Interface]
; Maximum number of elements in the folder history list
MaxFoldersHistory=10

[Interface]
;In Linux/MacOs Only if "Open Container Folder" give you error
FileOpenDoc=0

[Interface]
;Alternate File Manager (Windows Only)
FileManagerDefault={Full path to your File Manager .exe}
FileManagerDefaultParam={Alternate parameters, could be left blank}

[Interface]
;System Wide Shortcut key (Windows Only)
GlobalHotkey={Virtual Key Code} full list here http://docwiki.embarcadero.com/RADStudio/Seattle/en/Virtual_Key_Codes (Plus VK_A...VK_Z and VK_0..VK_9)
GlobalHotkeyMod={Modifier Key} [MOD_SHIFT , MOD_CONTROL , MOD_ALT , MOD_WIN alone or combined with + sign]

[Interface]
WatchLocalFolder= {LOCAL Folder to watch for torrent files}
WatchDestinationFolder= {REMOTE destination where the data would be saved if missing or empty last destination folder is used}
WatchInterval=1 {Time period in MINUTES between folder scans for torrents, may be fractional values 0,50 = 30 seconds}

[Shortcuts]
;Modify all the shortcuts of the GUI here

[Usermenu]
Caption1={Caption in the menu}
ExeName1={Full path to the program .exe you want to add to menu}
Params1="%s" {Usually "%s" but some programs may require additional parameters}
Caption2={same for item 2}
ExeName2={same for item 2}
Params2={same for item 2}

[StatusBarPanels]
;Customize the width of the statusbar panels to fit your language
;0 is the left most panel and 7 is the right most panel.
0=327
1=152
2=152
3=130
4=130
5=130
6=130
7=130

[MainForm]
BigToolBarHeight=48 {Height of the Big Icon Toolbar if missing default is 64}

[MainForm]
FromNow=1 {1=Shows the dates relatives to now , 0=Absolute Dates MM/DD/YY HH:MM:SS}

License

Copyright (c) 2008-2019 by Yury Sidorov and Transmission Remote GUI working group.

Transmission Remote GUI is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Transmission Remote GUI is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.