Transmissionのソースを表示

[[Category:インターネットアプリケーション]]
[[de:Transmission]]
[[en:Transmission]]
[[fr:Transmission]]
[[it:Transmission]]
[[zh-CN:Transmission]]
[http://www.transmissionbt.com/ Transmission] は軽量でクロスプラットフォームの BitTorrent クライアントです。多くの Linux ディストリビューションでデフォルトの BitTorrent クライアントとして使われています。

== インストール ==
[[公式リポジトリ]]には複数の選択肢があります:
* {{Pkg|transmission-cli}} - [[Wikipedia:Command-line interface|CLI]] とウェブクライアント (http://localhost:9091) インターフェイスが付属するデーモン。
* {{Pkg|transmission-remote-cli}} - デーモンの Curses インターフェイス。
* {{Pkg|transmission-gtk}} - GTK3 パッケージ。
* {{Pkg|transmission-qt}} - Qt5 パッケージ。

{{Note|The GTK client cannot connect to the daemon, so users wishing to use the daemon will need to consider using the Qt package for a GUI or the remote-cli package for a curses-based GUI.}}

== GUI バージョンの設定 ==
Both GUI versions, ''transmission-gtk'' and ''transmission-qt'', can function autonomously without a formal back-end daemon. 

GUI versions are configured to work out-of-the-box, but the user may wish to change some of the settings. The default path to the GUI configuration files is {{ic|~/.config/transmission}}.

A guide to configuration options can be found on the Transmission web site: https://trac.transmissionbt.com/wiki/EditConfigFiles#Options.

== Transmission-daemon と CLI ==

''transmission-cli'' のコマンド:
:''transmission-daemon'': デーモンを起動。
:''transmission-remote'': invokes the [[Wikipedia:Command-line interface|CLI]] for the daemon, whether local or remote, followed by the command you want the daemon to execute.
:''transmission-remote-cli'': (requires {{Pkg|transmission-remote-cli}}) starts the [[Wikipedia:curses (programming library)|curses]] interface for the daemon, whether local or remote.
:''transmission-cli'': starts a non-daemonized local instance of ''transmission'', for manually downloading a torrent.
:''transmission-show'': returns information on a given torrent file.
:''transmission-create'': creates a new torrent.
:''transmission-edit'': add, delete, or replace a tracker's announce URL.

=== デーモンの起動と停止 ===
[[#ユーザーの選択]] で説明されているように、{{ic|transmission}} デーモンは以下の方法で実行できます:

* As the user {{ic|transmission}}, by running as root: {{bc|# transmission-daemon}} The daemon can then be stopped with: {{bc|# killall transmission-daemon}}

* As your own user, by running under your user name: {{bc|$ transmission-daemon}} The daemon can then be stopped with: {{bc|$ killall transmission-daemon}}

* [[systemd#ユニットを使う|systemctl]] を使って {{ic|transmission}} サービスを起動 (停止) した場合 [[#ユーザーの選択]] で設定したユーザーが使われます。''systemd'' サービスの名前は {{ic|transmission}} であり {{ic|transmission-daemon}} ではありません。

デーモンを起動すると ''transmission'' の設定ファイルが作成されます。[[#デーモンの設定]] を見て下さい。

An alternative option to stop the {{ic|transmission}} daemon is to use the ''transmission-remote'' command:
 $ transmission-remote --exit

==== ブート時に自動起動 ====
システムの起動時に {{ic|transmission}} デーモンが実行されるようにするには、[[systemd#ユニットを使う|systemd]] を使います。

Note that the name for the ''systemd'' service is {{ic|transmission}}, not {{ic|transmission-daemon}}.

The daemon is started after {{ic|network.service}} was initialised. However, if you enable the service {{ic|dhcpcd}} as opposed to the device-specific service, such as {{ic|dhcpcd@enp1s0.service}} for example, it may happen that Transmission is started too early and cannot bind to the network interface. Thus, the web interface is unreachable. A possible solution is to add the {{ic|Requires}} line to the unit's [[systemd#Editing provided unit files|configuration file]]:

{{hc|/etc/systemd/system/transmission.service.d/fixdep.conf|2=
[Unit]
Requires=network.target
}}

==== ネットワークに接続された時に起動 ====

===== Wicd =====
Create a [[#デーモンの起動と停止|start script]] in folder {{ic|/etc/wicd/scripts/postconnect}}, and a [[#デーモンの起動と停止|stop script]] in folder {{ic|/etc/wicd/scripts/predisconnect}}. Remember to make them executable. For example:

{{hc|/etc/wicd/scripts/postconnect/transmission|2=
#!/bin/bash

/usr/bin/transmission-daemon
}}
{{hc|/etc/wicd/scripts/predisconnect/transmission|2=
#!/bin/bash

killall transmission-daemon
}}

=== ユーザーの選択 ===
{{ic|transmission}} を動かす方法を選択してください:

*別のユーザーで動かす、デフォルトは {{ic|transmission}} (セキュリティが良くなるので推奨)。
By default, ''transmission'' creates a user and a group {{ic|transmission}}, with its home files at {{ic|/var/lib/transmission/}}, and runs as this "user". This is a security precaution, so ''transmission'', and its downloads, have no access to files outside of {{ic|/var/lib/transmission/}}. Configuration, operation, and access to downloads needs to be done with "root" privileges (e.g. by using [[sudo]]).

*ユーザーの下で動かす
セットアップするには、サービスファイルを[[systemd#ユニットファイルの編集|上書き]]してユーザー名を指定してください:

{{hc|/etc/systemd/system/transmission.service.d/username.conf|2=
[Service]
User=''your_username''
}}

=== デーモンの設定 ===
[[#デーモンの起動と停止|デーモンを起動]]して設定ファイルを作成してください。

* If running Transmission under the username {{ic|transmission}}, the configuration file will be located at {{ic|/var/lib/transmission/.config/transmission-daemon/settings.json}}.

* If running Transmission under your own username, the configuration file will be located at {{ic|~/.config/transmission-daemon/settings.json}}.

One can customize the daemon by using a Transmission client or using the included web interface accessible via http://localhost:9091 in a supported browser.

A guide to configuration options can be found on the Transmission web site: https://trac.transmissionbt.com/wiki/EditConfigFiles#Options

{{Note|If you want to edit the configuration manually using a text editor, [[#Starting and stopping the daemon|stop the daemon]] first; otherwise, it would overwrite its configuration file when it closes.
}}
{{Note|Alternatively, the daemon can be instructed to reload its configuration with SIGHUP, by running {{ic|kill -s SIGHUP `pidof transmission-daemon`}}.
}}

A recommendation for those running under username {{ic|transmission}} is to create a shared download directory with the correct permissions to allow access to both the {{ic|transmission}} user and system users, and then to update the configuration file accordingly. For example:
 # mkdir /mnt/data/torrents
 # chown -R facade:transmission /mnt/data/torrents
 # chmod -R 775 /mnt/data/torrents

Now {{ic|/mnt/data/torrents}} will be accessible for the system user {{ic|facade}} and for the {{ic|transmission}} group to which the {{ic|transmission}} user belongs. Making the target directory world read/writable is highly discouraged (i.e. do not ''chmod'' the directory to ''777''). Instead, give individual users/groups appropriate permissions to the appropriate directories.

{{Note|If {{ic|/mnt/data/torrents}} is located on a removable device, e.g. with an {{ic|/etc/fstab}} entry with the option {{ic|nofail}}, Transmission will complain that it cannot find your files. To remedy this, you can add {{ic|1=RequiresMountsFor=/mnt/data/torrents}} to {{ic|/etc/systemd/system/transmission.service.d/transmission.conf}} in the section {{ic|[Unit]}}.}}

==== 監視ディレクトリ ====
If you want to ''Automatically add .torrent files from a folder'', but you find that the {{ic|watch-dir}} and {{ic|watch-dir-enabled}} options set in the config file do not work, you can start the transmission daemon with the flag {{ic|-c /path/to/watch/dir}}.

If you're using systemd, edit the unit file located at {{ic|/lib/systemd/system/transmission.service}}.

== 参照 ==
*[https://trac.transmissionbt.com/wiki Transmission wiki]
*[https://trac.transmissionbt.com/wiki/HeadlessUsage/General HeadlessUsage]