LinuxCommandLibrary

transmission-edit

Modify Transmission torrent properties

TLDR

Add a URL to a torrent's announce list

$ transmission-edit [[-a|--add]] [http://example.com] [path/to/file.torrent]
copy

Remove a URL from a torrent's announce list
$ transmission-edit [[-d|--delete]] [http://example.com] [path/to/file.torrent]
copy

Update a tracker's passcode in a torrent file
$ transmission-edit [[-r|--replace]] [old-passcode] [new-passcode] [path/to/file.torrent]
copy

SYNOPSIS

transmission-edit [options]

PARAMETERS

--help
    Display help message and exit.

--version
    Display version information and exit.


    The name of the setting to modify. Use `transmission-daemon --help` to view the available settings.


    The new value for the specified setting.

DESCRIPTION

The `transmission-edit` command allows users to modify Transmission's configuration file (`settings.json`) from the command line. It provides a simple interface to change various parameters of the Transmission daemon, such as download and upload limits, directory locations, encryption settings, and more. This tool is particularly useful for scripting configuration changes or managing a remote Transmission instance without direct file access. It simplifies the process of altering settings without manually editing the JSON file which could potentially introduce syntax errors. The settings are modified by specifying the settings name and its value after the command. It is important to stop the transmission daemon before editing the configuration file.

CAVEATS

Incorrect usage can corrupt the `settings.json` file, potentially preventing Transmission from starting. It is recommended to backup the file before using `transmission-edit`. The Transmission daemon must be stopped before running this command.

EXAMPLE USAGE

To change the download directory to `/mnt/downloads`, you would use the command:
`transmission-edit download-dir /mnt/downloads`

To enable encryption:
`transmission-edit encryption-required true`

SEE ALSO

Copied to clipboard