Skip to content
🧲 A feature rich cross platform Transmission BitTorrent client. Faster and has more functionality than the built-in web GUI.
Pascal Makefile PHP Ruby Emacs Lisp Inno Setup Other
Branch: master
Clone or download

Latest commit

Latest commit d1a9c9b May 26, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
Inno Setup lang Move Inno Setup translation out from origin lang directory Dec 22, 2017
lang Update Traditional Chinese translation Sep 28, 2019
setup Add Windows AMD64/64bit release Oct 11, 2019
snap Update Desktop file for Snap package [ci skip] Jun 30, 2019
synapse Fix Authorization Error when USER is empty but the PASSWORD is not #1099 Mar 21, 2018
.editorconfig Update .editorconfig Aug 9, 2019
.gitignore Add basic snap package files, #1109 Jun 28, 2019
.travis.yml Fix Travis CI deploy anchor, prevent it to be global config Oct 12, 2019
.whitesource Add .whitesource configuration file Aug 9, 2019
COPYING.FPC Make sure the final and single newline char at eof Apr 21, 2018
COPYING.txt Make sure the final and single newline char at eof Apr 21, 2018
GeoIP.pas Fix partial indentation of pas files Apr 22, 2018 Fix small English grammar issue in issue template [ci skip] Dec 26, 2018
LICENSE Retab LICENSE (1 Tab -> 8 Spaces) Dec 9, 2017
Makefile Set macOS builds to use cocoa Sep 8, 2019
Makefile.fpc Set macOS builds to use cocoa Sep 8, 2019 Update screenshot in README to v5.18.0 [ci skip] Apr 24, 2020
StringToVK.pas add exception May 1, 2020
VERSION.txt v5.18.0 Oct 11, 2019
about.lfm add exception May 1, 2020
about.pas add exception May 1, 2020
addlink.lfm * Use Lazarus 1.0 as a base development version. Dec 25, 2013
addlink.pas add exception May 1, 2020
addtorrent.lfm The trailing space removed. Nov 18, 2018
addtorrent.pas Fix absolute path error May 25, 2020
addtracker.lfm * Use Lazarus 1.0 as a base development version. Dec 25, 2013
addtracker.pas add exception May 1, 2020
baseform.lfm * Use Lazarus 1.0 as a base development version. Dec 25, 2013
baseform.pas add exception May 1, 2020
bencode.pas add exception May 1, 2020
colsetup.lfm * Use Lazarus 1.0 as a base development version. Dec 25, 2013
colsetup.pas add exception May 1, 2020
connoptions.lfm Add support for client certificate (p12) Feb 1, 2019
connoptions.pas add exception May 1, 2020
daemonoptions.lfm * Use Lazarus 1.0 as a base development version. Dec 25, 2013
daemonoptions.pas add exception May 1, 2020
download.lfm * Support for torrent links when handling duplicate torrents. Oct 14, 2013
download.pas add exception May 1, 2020 Optimize images and flag zip archive Jul 5, 2017
gcontnrs.pas Fix indentation, cc @leonsoft-kras Dec 26, 2018
history.txt v5.18.0 Oct 11, 2019
ipresolver.pas add exception May 1, 2020
lineinfo2.pp * svn props. Apr 4, 2012
maclocale.pas nothing important Nov 26, 2018
main.lfm Initial support for labels Apr 14, 2020
main.pas add exception May 1, 2020
movetorrent.lfm Use UNIX file format for lfm files Apr 21, 2018
movetorrent.pas add exception May 1, 2020
options.lfm Add support for client certificate (p12) Feb 1, 2019
options.pas add exception May 1, 2020
passwcon.lfm Issue #1123. Added own dialog for password input (*****). Jul 1, 2018
passwcon.pas add exception May 1, 2020
readme.txt add exception May 1, 2020
restranslator.pas add exception May 1, 2020
rpc-spec.txt Use DOS/Windows file format for txt files Apr 21, 2018
rpc.pas add exception May 1, 2020
torrprops.lfm * Use Lazarus 1.0 as a base development version. Dec 25, 2013
torrprops.pas add exception May 1, 2020
transgui.ico * Added 256x256 icon. May 1, 2010
transgui.lpi v5.18.0 Oct 11, 2019
transgui.lpr add exception May 1, 2020
transgui.png Optimize images and flag zip archive Jul 5, 2017
trcomp.lpk * Started to replace all TListView controls by own control TVarGrid (… Aug 7, 2010
trcomp.pas Remove trailing spaces Apr 21, 2018
urllistenerosx.pas add exception May 1, 2020
utils.pas add exception May 1, 2020
vargrid.pas add exception May 1, 2020
varlist.pas add exception May 1, 2020

Transmission Remote GUI

Build Status


Table of Contents


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.


  • Native application for Windows, Linux and macOS
  • uTorrent-like interface
  • Select files to download
  • Choose files priority
  • View details about connected peers
  • Full information about each torrent
  • Per torrent options


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


Easy way (recommended)

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

  • Download and extract the release for your architecture.

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.
  • Free Pascal Compiler 2.6.2+ and Lazarus 1.6 is used to develop Transmission Remote GUI.
  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 make command to build the application.
  4. Execute make zipdist command to create a release .zip archive in the Release sub-folder.


Portable zip tarball (recommended)

  • Zip tarball release is much more small than the installer one, which can save you some bandwidth, disk space and time, just simply download and extract the zip tarball to wherever you want, directly execute transgui.exe or add shortcut for it.

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.


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 cinst transgui to install the latest version of Transmission Remote GUI.


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.


You need to have Homebrew installed, and Homebrew-Cask enabled, with Homebrew, you can enable Homebrew-Cask by a single command, skip this step if you already got it:

  • brew tap caskroom/cask

With Homebrew-Cask, directly execute this command to install Transmission Remote Gui:

  • brew cask 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.

  • -hidden : Start the program hidden. Only the program's tray icon will be visible.
  • --home=<home_dir> : Specifies a home directory for the program. All program's settings are stored in the home directory. You can run multiple instances of the program by specifying different home directories.

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

  • Alt + 1 : All Torrents
  • Alt + 2 : Downloading
  • Alt + 3 : Completed
  • Alt + 4 : Active
  • Alt + 5 : Inactive
  • Alt + 6 : Stopped
  • Alt + 7 : Error
  • Alt + 8 : Waiting
  • Alt + S : Searchbox (filter torrents by keywords) - Esc cancel filter and clean the box.
  • Alt + G : Info Pane - General Tab
  • Alt + K : Info Pane - Trackers Tab
  • Alt + P : Info Pane - Peers Tab
  • Alt + F : Info Pane - Files Tab

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)

; Maximum number of elements in the folder history list

;In Linux/MacOs Only if "Open Container Folder" give you error

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

;System Wide Shortcut key (Windows Only)
GlobalHotkey={Virtual Key Code} full list here (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]

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}

;Modify all the shortcuts of the GUI here

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}

;Customize the width of the statusbar panels to fit your language
;0 is the left most panel and 7 is the right most panel.

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

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


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.

You can’t perform that action at this time.