This documentation will not describe all RPC fields in detail. Please refer to the RPC specification for more information on RPC data.
Contents
This exception is raised when there has occurred an error related to communication with Transmission. It is a subclass of Exception.
The original exception.
This exception is raised when there has occurred an error related to the HTTP handler. It is a subclass of Exception.
The requested url.
HTTP error code.
HTTP error message.
HTTP headers.
HTTP data.
Torrent is a class holding the information received from Transmission regarding a bittorrent transfer. All fetched torrent fields are accessible through this class using attributes. The attributes use underscore instead of hyphen in the names though. This class has a few convenience attributes using the torrent information.
Example:
>>> import transmissionrpc
>>> t = transmissionrpc.Torrent({'id': 1, 'comment': 'My torrent', 'addedDate': 1232281019})
>>> t.comment
'My torrent'
>>> t.date_added
datetime.datetime(2009, 1, 18, 13, 16, 59)
>>>
Torrent is a class holding the data received from Transmission regarding a bittorrent transfer. All fetched torrent fields are accessible through this class using attributes. This class has a few convenience properties using the torrent data.
Get the attribute “activityDate” as datetime.datetime.
Get the attribute “addedDate” as datetime.datetime.
Get the attribute “doneDate” as datetime.datetime.
Get the attribute “startDate” as datetime.datetime.
Get the “eta” as datetime.timedelta.
Get list of files for this torrent.
This function returns a dictionary with file information for each file. The file information is has following fields:
{
<file id>: {
'name': <file name>,
'size': <file size in bytes>,
'completed': <bytes completed>,
'priority': <priority ('high'|'normal'|'low')>,
'selected': <selected for download>
}
...
}
Returns the attribute eta formatted as a string.
Get the priority as string. Can be one of ‘low’, ‘normal’, ‘high’.
Get the download progress in percent.
Get the upload/download ratio.
Returns the torrent status. Is either one of ‘check pending’, ‘checking’, ‘downloading’, ‘seeding’ or ‘stopped’. The first two is related to verification.
Update the torrent data from a Transmission JSON-RPC arguments dictionary
Session is a class holding the session data for a Transmission session.
Access the session field can be done through attributes. The attributes available are the same as the session arguments in the Transmission RPC specification, but with underscore instead of hyphen. download-dir -> download_dir.
fields should be an dictionary build from session information from an Transmission JSON-RPC result.
Updates the Session object with data from other.
other should be a Session object or session information from an Transmission JSON-RPC result.
This is it. This class implements the JSON-RPC protocol to communicate with Transmission.
Many functions in Client takes torrent id. A torrent id can either be id or hashString. When supplying multiple id’s it is possible to use a list mixed with both id and hashString.
In Python 2.6 it is possible to supply a timeout to a HTTP request. This is accessible through transmissionrpc by either changing the timeout property of a Client object or supply the named argument timeout in most methods of Client. The default timeout is 30 seconds.
Client is the class handling the Transmission JSON-RPC client protocol.
Add torrent to transfers list. Takes a base64 encoded .torrent file in data. Additional arguments are:
Argument | RPC | Replaced by | Description |
---|---|---|---|
bandwidthPriority | 8 - | Priority for this transfer. | |
cookies | 13 - | One or more HTTP cookie(s). | |
download_dir | 1 - | The directory where the downloaded contents will be saved in. | |
files_unwanted | 1 - | A list of file id’s that shouldn’t be downloaded. | |
files_wanted | 1 - | A list of file id’s that should be downloaded. | |
paused | 1 - | If True, does not start the transfer when added. | |
peer_limit | 1 - | Maximum number of peers allowed. | |
priority_high | 1 - | A list of file id’s that should have high priority. | |
priority_low | 1 - | A list of file id’s that should have low priority. | |
priority_normal | 1 - | A list of file id’s that should have normal priority. |
Add torrent to transfers list. Takes a uri to a torrent, supporting all uri’s supported by Transmissions torrent-add ‘filename’ argument. Additional arguments are:
Argument | RPC | Replaced by | Description |
---|---|---|---|
bandwidthPriority | 8 - | Priority for this transfer. | |
cookies | 13 - | One or more HTTP cookie(s). | |
download_dir | 1 - | The directory where the downloaded contents will be saved in. | |
files_unwanted | 1 - | A list of file id’s that shouldn’t be downloaded. | |
files_wanted | 1 - | A list of file id’s that should be downloaded. | |
paused | 1 - | If True, does not start the transfer when added. | |
peer_limit | 1 - | Maximum number of peers allowed. | |
priority_high | 1 - | A list of file id’s that should have high priority. | |
priority_low | 1 - | A list of file id’s that should have low priority. | |
priority_normal | 1 - | A list of file id’s that should have normal priority. |
Update block list. Returns the size of the block list.
Change torrent parameters for the torrent(s) with the supplied id’s. The parameters are:
Argument | RPC | Replaced by | Description |
---|---|---|---|
bandwidthPriority | 5 - | Priority for this transfer. | |
downloadLimit | 5 - | Set the speed limit for download in Kib/s. | |
downloadLimited | 5 - | Enable download speed limiter. | |
files_unwanted | 1 - | A list of file id’s that shouldn’t be downloaded. | |
files_wanted | 1 - | A list of file id’s that should be downloaded. | |
honorsSessionLimits | 5 - | Enables or disables the transfer to honour the upload limit set in the session. | |
location | 1 - | Local download location. | |
peer_limit | 1 - | The peer limit for the torrents. | |
priority_high | 1 - | A list of file id’s that should have high priority. | |
priority_low | 1 - | A list of file id’s that should have normal priority. | |
priority_normal | 1 - | A list of file id’s that should have low priority. | |
queuePosition | 14 - | Position of this transfer in its queue. | |
seedIdleLimit | 10 - | Seed inactivity limit in minutes. | |
seedIdleMode | 10 - | Seed inactivity mode. 0 = Use session limit, 1 = Use transfer limit, 2 = Disable limit. | |
seedRatioLimit | 5 - | Seeding ratio. | |
seedRatioMode | 5 - | Which ratio to use. 0 = Use session limit, 1 = Use transfer limit, 2 = Disable limit. | |
speed_limit_down | 1 - 5 | downloadLimit | Set the speed limit for download in Kib/s. |
speed_limit_down_enabled | 1 - 5 | downloadLimited | Enable download speed limiter. |
speed_limit_up | 1 - 5 | uploadLimit | Set the speed limit for upload in Kib/s. |
speed_limit_up_enabled | 1 - 5 | uploadLimited | Enable upload speed limiter. |
trackerAdd | 10 - | Array of string with announce URLs to add. | |
trackerRemove | 10 - | Array of ids of trackers to remove. | |
trackerReplace | 10 - | Array of (id, url) tuples where the announce URL should be replaced. | |
uploadLimit | 5 - | Set the speed limit for upload in Kib/s. | |
uploadLimited | 5 - | Enable upload speed limiter. |
Note
transmissionrpc will try to automatically fix argument errors.
Get list of files for provided torrent id(s). If ids is empty, information for all torrents are fetched. This function returns a dictionary for each requested torrent id holding the information about the files.
{
<torrent id>: {
<file id>: {
'name': <file name>,
'size': <file size in bytes>,
'completed': <bytes completed>,
'priority': <priority ('high'|'normal'|'low')>,
'selected': <selected for download (True|False)>
}
...
}
...
}
Get session parameters
Get detailed information for torrent(s) with provided id(s).
list all torrents
Locate torrent data at the location.
Move torrent data to the new location.
Tests to see if your incoming peer port is accessible from the outside world.
Move transfer to the bottom of the queue.
Move transfer down in the queue.
Move transfer to the top of the queue.
Move transfer up in the queue.
Reannounce torrent(s) with provided id(s)
remove torrent(s) with provided id(s). Local data is removed if delete_data is True, otherwise not.
Get the Transmission RPC version. Trying to deduct if the server don’t have a version value.
Get session statistics
Set file properties. Takes a dictionary with similar contents as the result of get_files.
{
<torrent id>: {
<file id>: {
'priority': <priority ('high'|'normal'|'low')>,
'selected': <selected for download (True|False)>
}
...
}
...
}
Set session parameters. The parameters are:
Argument | RPC | Replaced by | Description |
---|---|---|---|
alt_speed_down | 5 - | Alternate session download speed limit (in Kib/s). | |
alt_speed_enabled | 5 - | Enables alternate global download speed limiter. | |
alt_speed_time_begin | 5 - | Time when alternate speeds should be enabled. Minutes after midnight. | |
alt_speed_time_day | 5 - | Enables alternate speeds scheduling these days. | |
alt_speed_time_enabled | 5 - | Enables alternate speeds scheduling. | |
alt_speed_time_end | 5 - | Time when alternate speeds should be disabled. Minutes after midnight. | |
alt_speed_up | 5 - | Alternate session upload speed limit (in Kib/s). | |
blocklist_enabled | 5 - | Enables the block list | |
blocklist_url | 11 - | Location of the block list. Updated with blocklist-update. | |
cache_size_mb | 10 - | The maximum size of the disk cache in MB | |
dht_enabled | 6 - | Enables DHT. | |
download_dir | 1 - | Set the session download directory. | |
download_queue_enabled | 14 - | Enable parallel download restriction. | |
download_queue_size | 14 - | Number of parallel downloads. | |
encryption | 1 - | Set the session encryption mode, one of required, preferred or tolerated. | |
idle_seeding_limit | 10 - | The default seed inactivity limit in minutes. | |
idle_seeding_limit_enabled | 10 - | Enables the default seed inactivity limit | |
incomplete_dir | 7 - | The path to the directory of incomplete transfer data. | |
incomplete_dir_enabled | 7 - | Enables the incomplete transfer data directory. Otherwise data for incomplete transfers are stored in the download target. | |
lpd_enabled | 9 - | Enables local peer discovery for public torrents. | |
peer_limit | 1 - 5 | peer-limit-global | Maximum number of peers |
peer_limit_global | 5 - | Maximum number of peers | |
peer_limit_per_torrent | 5 - | Maximum number of peers per transfer | |
peer_port | 5 - | Peer port. | |
peer_port_random_on_start | 5 - | Enables randomized peer port on start of Transmission. | |
pex_allowed | 1 - 5 | pex-enabled | Allowing PEX in public torrents. |
pex_enabled | 5 - | Allowing PEX in public torrents. | |
port | 1 - 5 | peer-port | Peer port. |
port_forwarding_enabled | 1 - | Enables port forwarding. | |
queue_stalled_enabled | 14 - | Enable tracking of stalled transfers. | |
queue_stalled_minutes | 14 - | Number of minutes of idle that marks a transfer as stalled. | |
rename_partial_files | 8 - | Appends ”.part” to incomplete files | |
script_torrent_done_enabled | 9 - | Whether or not to call the “done” script. | |
script_torrent_done_filename | 9 - | Filename of the script to run when the transfer is done. | |
seed_queue_enabled | 14 - | Enable parallel upload restriction. | |
seed_queue_size | 14 - | Number of parallel uploads. | |
seedRatioLimit | 5 - | Seed ratio limit. 1.0 means 1:1 download and upload ratio. | |
seedRatioLimited | 5 - | Enables seed ration limit. | |
speed_limit_down | 1 - | Download speed limit (in Kib/s). | |
speed_limit_down_enabled | 1 - | Enables download speed limiting. | |
speed_limit_up | 1 - | Upload speed limit (in Kib/s). | |
speed_limit_up_enabled | 1 - | Enables upload speed limiting. | |
start_added_torrents | 9 - | Added torrents will be started right away. | |
trash_original_torrent_files | 9 - | The .torrent file of added torrents will be deleted. | |
utp_enabled | 13 - | Enables Micro Transport Protocol (UTP). |
Note
transmissionrpc will try to automatically fix argument errors.
start torrent(s) with provided id(s)
stop torrent(s) with provided id(s)
HTTP query timeout.
verify torrent(s) with provided id(s)