1FLUSH(1)                    General Commands Manual                   FLUSH(1)
2
3
4

NAME

6       Flush - GTK-based BitTorrent client
7
8

SYNOPSIS

10       flush [OPTIONS] [TORRENT_FILE]...
11
12

DESCRIPTION

14       Flush  is  a  GTK-based  BitTorrent  client. You can use it to download
15       files from the BitTorrent network.
16
17       You can control already running instance,  for  example,  by  following
18       commands:
19              flush -o --download-rate-limit=100
20              flush --start=all
21
22

FEATURES

24       * Controlling running instance by command line interface, such as:
25         * Starting/stopping torrents.
26         * Changing download/upload rate limit.
27         * Changing maximum connections limit.
28       * Running many instances with different configs from the same user.
29       * Automatic copying finished downloads to specified directory.
30       * Setting custom download path for each file of the torrent.
31       * Ability to choose torrent file's character set encoding.
32       * Automatic torrents loading from specified directory.
33       * Automatic pausing and removing old torrents.
34       * Temporary pausing and resuming torrents.
35       * Overall and current session statistics.
36       * Creating your own torrent files.
37       * IP filter.
38
39

OPTIONS

41       --version
42              Show program version and exit.
43
44       --help Show help options and exit.
45
46       --config=DIRECTORY
47              Configuration directory path (default: ~/.flush).
48
49       --download-rate-limit=SPEED
50              Set download rate limit (KB/s).
51
52       --upload-rate-limit=SPEED
53              Set upload rate limit (KB/s).
54
55       --max-uploads=NUMBER
56              Set maximum uploads.
57
58       --max-connections=NUMBER
59              Set maximum connections.
60
61       --start={all,downloads,uploads}
62              Start torrents.
63
64       --stop={all,downloads,uploads}
65              Stop torrents.
66
67       -o, --only-pass
68              Only  pass  commands to already running Flush instance. Does not
69              start new instance if it is not running yet.
70
71

FILES

73       ~/.flush
74              Default configuration directory.
75
76

BUGS

78       On startup Flush finds already running instances via DBus session  bus.
79       Therefore  it  is necessary to run Flush in a single session bus (usual
80       in X session bus) to prevent running several instances with one config‐
81       uration path.
82
83       Please  notice that when you are running Flush from console or by cron,
84       when DISPLAY environment variable is not available, Flush finds already
85       running  GUI  instance without problems via ${config_path}/dbus_session
86       link, which all GUI instances are creating when they  have  owned  DBus
87       name.  This  makes  it  possible to control running Flush GUI instances
88       from cron.
89
90

AUTHOR

92       Flush was written by Dmitry Konishchev <konishchev@gmail.com>.
93       This   manual   page   was   written   by   Dmitry   Konishchev   <kon‐
94       ishchev@gmail.com>.
95
96
97
98                                 Jun 11, 2009                         FLUSH(1)