Transmission: Difference between revisions

(4 intermediate revisions by 2 users not shown)

Line 1:

[https://transmissionbt.com/ Transmission] is a lightweight, open-source BitTorrent client for Linux that provides both GUI and command-line interfaces for efficient torrent downloading and seeding.

== Installation ==

Install by adding transmission_4-qt or transmission_4-gtk to your packages list

environment.systemPackages = with pkgs; [ transmission_4-qt ];

</syntaxHighlight>

<syntaxhighlight lang="nix">environment.systemPackages = with pkgs; [ transmission_4-gtk ];</syntaxhighlight>

If you want to configure the settings declaratively with within configuration.nix, you will have to instead install transmission-qt or transmission-gtk. Do note that this is using version 3.0.0 instead of version 4.

environment.systemPackages = with pkgs; [ transmission-qt ];

</syntaxHighlight>

environment.systemPackages = with pkgs; [ transmission-gtk ];

</syntaxHighlight>

== Service configuration ==

~~{{note| This section was created in 2017 and this workaround may not be needed anymore for changing~~ settings~~. This will stay until final confirmation occurs.}}~~

You can declaratively change the settings via Nix by modifying <code>services.transmission.settings</code>. [https://search.nixos.org/options?type=packages&query=transmission.settings View the documentation for more info]. Like the previous section has said before, you'll have to use the nixpkgs transmission-gtk or transmission-qt for this to work.

~~Changes to the configuration in the interface will not persist when the application is re-launched.~~ <code>services.transmission.settings</code> ~~is reset each time~~ the ~~service restarts~~.

<~~blockquote~~>

Example:

~~Attribute set whos[e] fields overwrites fields in settings~~.~~json (each~~

~~time the service starts)~~. ~~String values must be quoted, integer and~~

services.transmission.settings = {

~~boolean values must not.~~

download-dir = "${config.services.transmission.home}/Downloads";

~~</blockquote>~~

};

~~<cite>[https://github~~.~~com/NixOS/nixpkgs/blob/dd705fb45fd17c078522dedb76ee710ed4d3af4b/nixos/modules/~~services~~/torrent/transmission~~.~~nix#L64:L71 <nixpkgs>/nixos/modules/services/torrent/~~transmission.~~nix]<~~/~~cite>~~

~~To persist changes, edit them, look at the~~ <~~code>[services.transmission.home]~~/~~.config/transmission-daemon/settings.json</code> file generated for the setting keys and their values, and save them to <code>services.transmission.settings</code~~>

</syntaxHighlight>

=== Password-protected RPC ===

@@ Line 1: / Line 1: @@
 {{expansion}}
+[https://transmissionbt.com/ Transmission] is a lightweight, open-source BitTorrent client for Linux that provides both GUI and command-line interfaces for efficient torrent downloading and seeding.
+== Installation ==
+Install by adding transmission_4-qt or transmission_4-gtk to your packages list
+<syntaxHighlight lang=nix>
+environment.systemPackages = with pkgs; [ transmission_4-qt ];
+</syntaxHighlight>
+<syntaxhighlight lang="nix">environment.systemPackages = with pkgs; [ transmission_4-gtk ];</syntaxhighlight>
+If you want to configure the settings declaratively with within configuration.nix, you will have to instead install transmission-qt or transmission-gtk. Do note that this is using version 3.0.0 instead of version 4.
+<syntaxHighlight lang=nix>
+environment.systemPackages = with pkgs; [ transmission-qt ];
+</syntaxHighlight>
+<syntaxHighlight lang=nix>
+environment.systemPackages = with pkgs; [ transmission-gtk ];
+</syntaxHighlight>
 == Service configuration ==
-{{note| This section was created in 2017 and this workaround may not be needed anymore for changing settings. This will stay until final confirmation occurs.}}
+You can declaratively change the settings via Nix by modifying <code>services.transmission.settings</code>. [https://search.nixos.org/options?type=packages&query=transmission.settings View the documentation for more info]. Like the previous section has said before, you'll have to use the nixpkgs transmission-gtk or transmission-qt for this to work.
-Changes to the configuration in the interface will not persist when the application is re-launched. <code>services.transmission.settings</code> is reset each time the service restarts.
-<blockquote>
+Example:
-Attribute set whos[e] fields overwrites fields in settings.json (each
+<syntaxHighlight lang=nix>
-time the service starts). String values must be quoted, integer and
+services.transmission.settings = {
-boolean values must not.
+  download-dir = "${config.services.transmission.home}/Downloads";
-</blockquote>
+};
-<cite>[https://github.com/NixOS/nixpkgs/blob/dd705fb45fd17c078522dedb76ee710ed4d3af4b/nixos/modules/services/torrent/transmission.nix#L64:L71 <nixpkgs>/nixos/modules/services/torrent/transmission.nix]</cite>
-To persist changes, edit them, look at the <code>[services.transmission.home]/.config/transmission-daemon/settings.json</code> file generated for the setting keys and their values, and save them to <code>services.transmission.settings</code>
+</syntaxHighlight>
 === Password-protected RPC ===