summaryrefslogtreecommitdiffstats
path: root/doc/en/using.docbook
blob: 631afc769284407dc169e983dd7bbf25778570eb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
<chapter id="using">
<title>Using &ktorrent;</title>

<sect1 id="add-torrent">
<title>Adding a Torrent</title>

<sect2 id="open-torrent">
<title>Opening a Torrent</title>

<!--<para>
To open a torrent located on your computer, use <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem><shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut></menuchoice>. This will launch a dialog in which you will locate the torrent you wish to open.
</para>-->

<!--<screenshot>
<screeninfo>Open Torrent Location</screeninfo>
<inlinemediaobject>
<imageobject>
<imagedata fileref="opentorrent-location.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Open Torrent Location</phrase>
</textobject>
</inlinemediaobject>
</screenshot>-->

<para>
To open a torrent directly from a web site, use <menuchoice><guimenu>File</guimenu><guimenuitem>Open URL</guimenuitem></menuchoice>. This will launch a dialog in which you can paste location of the torrent you wish to open.
</para>

<!--<screenshot>
<screeninfo>Open Torrent Location</screeninfo>
<inlinemediaobject>
<imageobject>
<imagedata fileref="opentorrent-url.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Open Torrent Location</phrase>
</textobject>
</inlinemediaobject>
</screenshot>-->

</sect2>

<sect2 id="torrent-options">
<title>Torrent and Data Options</title>

<para>
After you have opened a torrent, following dialog will appear, where you can modify default options. When you are <guilabel>OK</guilabel> to add torrent.
</para>

<!--<screenshot>
<screeninfo>Open Torrent Files</screeninfo>
<inlinemediaobject>
<imageobject>
<imagedata fileref="opentorrent-files.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Open Torrent Files</phrase>
</textobject>
</inlinemediaobject>
</screenshot>-->

<variablelist>

<!--<varlistentry>
<term><guilabel>Download to:</guilabel></term>
<listitem>
<para>
Where to store torrents data (<link linkend="default-save-location">Default save location</link>).
</para>
</listitem>
</varlistentry>-->

<varlistentry>
<term><guilabel>Group:</guilabel></term>
<listitem>
<para>
With this option you can add opened torrent to a <link linkend="groups">custom group</link>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>User controlled</guilabel></term>
<listitem>
<para>
Use this option to manually start and stop this torrent. Selecting this option will not set torrent as quelled in the Queue Manager.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Start torrent</guilabel></term>
<listitem>
<para>
Whether or not to start downloading a torrent.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Toplevel directory:</guilabel></term>
<listitem>
<para>
Name of the directory in which to save files of a multifile torrent. Setting the same directory name, you can download two different torrents with exactly same files.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Skip data check if existing files are found</guilabel></term>
<listitem>
<para>
When selected, data will not be checked for errors if files exists.
</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="import-torrent">
<title>Partialy Downloaded Torrent</title>

<para>
Partialy Downloaded Torrent
</para>

</sect2>

</sect1>

<sect1 id="groups">
<title>Grouping Torrents</title>

<para>
&ktorrent; is able to display your torrents in diffrent groups. There are several default groups which will display torrents by their state (downloading or uploading) or activity (running or not). You can also choose their sub-category groups. To display all torrents use <guilabel>All Torrents</guilabel> group.
</para>

<para>
To create a custom group and add a torrent to that group, do following:
</para>

<!--<procedure>
<step>
Click with &RMB; anywhere in <guilabel>Groups</guilabel> tab, select <guilabel>New Group</guilabel> from the menu and then enter name for that group
</step>
<step>
Click on a torrent you want to add with &RMB; and from the <guilabel>Add to Group</guilabel> submenu select the group
</step>
</procedure>-->


<para>
Torrents that are not in any custom group will appear under <guilabel>Ungrouped Torrents</guilabel>.
</para>

</sect1>

<sect1 id="queuemanager">
<title>Queue Manager</title>

<para>
The Queue Manager enables you to fully automatize starting and stopping of torrents. This is useful when you want to dedicate your bandwidth to few torrents and automatically start next torrent when one is finished. When a torrent is opened in &ktorrent;, it will be quelled and set as last in the list of quelled torrents.
</para>

<!--<para>
To set the number of torrents you want to download and seed simultaneously, open configuration dialog and in the <link linkend="queuemanager-config">Queue Manager panel</link> set <guilabel>Maximum downloads</guilabel> and <guilabel>Maximum seeds</guilabel> to your preference. You can also use <link linkend="recommended-options">recommended options</link> to set this settings. If you do not want to queue your torrents set both options to <option>0</option> (unlimited).
</para>-->

<para>
You can queue and dequeue torrents in the <guilabel>Queue Manager</guilabel> tab, located in the bottom left corner of &ktorrent; window. There you can also reorder your quelled torrents.
</para>

<note><para>
If you manually start or stop a quelled torrent, that torrent will be dequelled.
</para></note>

</sect1>

</chapter>