btdownloadgui(1) GUI bittorrent download interface


btdownloadgui [options ...] URL

btdownloadgui [options ...] filename


This manual page documents briefly the btdownloadgui command.

This manual page was written for the Debian distribution because the original program does not have a manual page.

btdownloadgui is a GUI interface to download torrents.

btdownloadgui will open a provided torrent URL or file and download it until complete. It will then seed (upload) the torrent until it is stopped.


This program follows the usual GNU command line syntax, with long options starting with two dashes (`--'). A summary of options is included below.

In addition to the program-specific options described below, this program uses the same common options as the other bittorrent downloaders, which are documented in bittorrent-downloader(1).

--win32_taskbar_icon 0|1
whether to iconize to the system try or not (only for win32) (defaults to 1)
--gui_stretchwindow 0|1
whether to stretch the download status window to fit the torrent name (defaults to 0)
--gui_displaystats 0|1
whether to display statistics on peers and seeds (defaults to 1)
--gui_displaymiscstats 0|1
whether to display miscellaneous other statistics (defaults to 1)
--gui_ratesettingsdefault automatic|unlimited|dialup/isdn|dsl/cable slow|dsl/cable fast|T1|T3+|seeder
the default rate setting to use for maximum upload rate (options are 'automatic', 'unlimited', 'dialup/isdn', 'dsl/cable slow', 'dsl/cable fast', 'T1', 'T3+', 'seeder') (defaults to 'automatic')
--gui_ratesettingsmode none|basic|full
the rate setting controls to display (options are 'none', 'basic', and 'full') (defaults to 'full')
--gui_forcegreenonfirewall 0|1
forces the status icon to be green even if the client seems to be firewalled (defaults to 0)
--gui_default_savedir directory
the default directory to save to (defaults to '')
--last_saved directory
the directory where the last torrent was saved (defaults to '')
--gui_font size
the font size to use (defaults to 10)
--gui_saveas_ask 0|1|-1
whether to ask where to download to (0 = never, 1 = always, -1 = automatic resume) (defaults to 0)
--gui_checkingcolor color
the color to use for the progress bar when checking (defaults to '92 91 8d')
--gui_downloadcolor color
the color to use for the progress bar when downloading (defaults to '4b 69 83')
--gui_seedingcolor color
the color to use for the progress bar when seeding (defaults to '00 ff 00')


This manual page was written by Cameron Dale <[email protected]> (based on the original man pages written by Micah Anderson <[email protected]>) for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.