自用transmission rpc

Transmission's RPC specification

This document describes a protocol for interacting with Transmission sessions remotely.

1.1 Terminology

The JSON terminology in RFC 4627 is used. RPC requests and responses are formatted in JSON.

1.2 Tools

If transmission-remote is called with a --debug argument, its RPC traffic to the Transmission server will be dumped to the terminal. This can be useful when you want to compare requests in your application to another for reference.

If transmission-qt is run with an environment variable TR_RPC_VERBOSE set, it too will dump the RPC requests and responses to the terminal for inspection.

Lastly, using the browser's developer tools in the Transmission web client is always an option.

1.3 Libraries of ready-made wrappers

Some people outside of the Transmission project have written libraries that wrap this RPC API. These aren't supported by the Transmission project, but are listed here in the hope that they may be useful:

LanguageLink
C#https://www.nuget.org/packages/Transmission.API.RPC
Gohttps://github.com/hekmon/transmissionrpc
Pythonhttps://github.com/Trim21/transmission-rpc
Rusthttps://crates.io/crates/transmission-rpc

2 Message format

Messages are formatted as objects. There are two types: requests (described in section 2.1) and responses (described in section 2.2).

All text must be UTF-8 encoded.

2.1 Requests

Requests support three keys:

  1. A required method string telling the name of the method to invoke
  2. An optional arguments object of key/value pairs. The keys allowed are defined by the method.
  3. An optional tag number used by clients to track responses. If provided by a request, the response MUST include the same tag.
{
   "arguments": {
     "fields": [
       "version"
     ]
   },
   "method": "session-get",
   "tag": 912313
}

2.2 Responses

Responses to a request will include:

  1. A required result string whose value MUST be success on success, or an error string on failure.
  2. An optional arguments object of key/value pairs. Its keys contents are defined by the method and arguments of the original request.
  3. An optional tag number as described in 2.1.
{
   "arguments": {
      "version": "2.93 (3c5870d4f5)"
   },
   "result": "success",
   "tag": 912313
}

2.3 Transport mechanism

HTTP POSTing a JSON-encoded request is the preferred way of communicating with a Transmission RPC server. The current Transmission implementation has the default URL as http://host:9091/transmission/rpc. Clients may use this as a default, but should allow the URL to be reconfigured, since the port and path may be changed to allow mapping and/or multiple daemons to run on a single server.

2.3.1 CSRF protection

Most Transmission RPC servers require a X-Transmission-Session-Id header to be sent with requests, to prevent CSRF attacks.

When your request has the wrong id -- such as when you send your first request, or when the server expires the CSRF token -- the Transmission RPC server will return an HTTP 409 error with the right X-Transmission-Session-Id in its own headers.

So, the correct way to handle a 409 response is to update your X-Transmission-Session-Id and to resend the previous request.

2.3.2 DNS rebinding protection

Additional check is being made on each RPC request to make sure that the client sending the request does so using one of the allowed hostnames by which RPC server is meant to be available.

If host whitelisting is enabled (which is true by default), Transmission inspects the Host:HTTP header value (with port stripped, if any) and matches it to one of the whitelisted names. Regardless of host whitelist content, localhost and localhost. domain names as well as all the IP addresses are always implicitly allowed.

For more information on configuration, see settings.json documentation for rpc-host-whitelist-enabled and rpc-host-whitelist keys.

2.3.3 Authentication

Enabling authentication is an optional security feature that can be enabled on Transmission RPC servers. Authentication occurs by method of HTTP Basic Access Authentication.

If authentication is enabled, Transmission inspects the Authorization: HTTP header value to validate the credentials of the request. The value of this HTTP header is expected to be Basic <b64 credentials>, where is equal to a base64 encoded string of the username and password (respectively), separated by a colon.

3 Torrent requests

3.1 Torrent action requests

Method namelibtransmission function
torrent-starttr_torrentStart
torrent-start-nowtr_torrentStartNow
torrent-stoptr_torrentStop
torrent-verifytr_torrentVerify
torrent-reannouncetr_torrentManualUpdate ("ask tracker for more peers")

Request arguments: ids, which specifies which torrents to use. All torrents are used if the ids argument is omitted.

ids should be one of the following:

  1. an integer referring to a torrent id
  2. a list of torrent id numbers, SHA1 hash strings, or both
  3. a string, recently-active, for recently-active torrents

Response arguments: none

3.2 Torrent mutator: torrent-set

Method name: torrent-set

Request arguments:

KeyValue TypeValue Description
bandwidthPrioritynumberthis torrent's bandwidth tr_priority_t
downloadLimitnumbermaximum download speed (KBps)
downloadLimitedbooleantrue if downloadLimitis honored
files-unwantedarrayindices of file(s) to not download
files-wantedarrayindices of file(s) to download
groupstringThe name of this torrent's bandwidth group
honorsSessionLimitsbooleantrue if session upload limits are honored
idsarraytorrent list, as described in 3.1
labelsarrayarray of string labels
locationstringnew location of the torrent's content
peer-limitnumbermaximum number of peers
priority-higharrayindices of high-priority file(s)
priority-lowarrayindices of low-priority file(s)
priority-normalarrayindices of normal-priority file(s)
queuePositionnumberposition of this torrent in its queue [0...n)
seedIdleLimitnumbertorrent-level number of minutes of seeding inactivity
seedIdleModenumberwhich seeding inactivity to use. See tr_idlelimit
seedRatioLimitdoubletorrent-level seeding ratio
seedRatioModenumberwhich ratio to use. See tr_ratiolimit
sequentialDownloadbooleandownload torrent pieces sequentially
trackerAddarrayDEPRECATEDuse trackerList instead
trackerListstringstring of announce URLs, one per line, and a blank line between tiers.
trackerRemovearrayDEPRECATEDuse trackerList instead
trackerReplacearrayDEPRECATEDuse trackerList instead
uploadLimitnumbermaximum upload speed (KBps)
uploadLimitedbooleantrue if uploadLimit is honored

Just as an empty ids value is shorthand for "all ids", using an empty array for files-wantedfiles-unwantedpriority-highpriority-low, or priority-normal is shorthand for saying "all files".

Response arguments: none

3.3 Torrent accessor: torrent-get

Method name: torrent-get.

Request arguments:

  1. An optional ids array as described in 3.1.
  2. A required fields array of keys. (see list below)
  3. An optional format string specifying how to format the torrents response field. Allowed values are objects(default) and table. (see "Response arguments" below)

Response arguments:

  1. torrents array.

    If the format request was objects(default), torrents will be an array of objects, each of which contains the key/value pairs matching the request's fields arg. This was the only format before Transmission 3 and has some obvious programmer conveniences, such as parsing directly into Javascript objects.

    If the format was table, then torrents will be an array of arrays. The first row holds the keys and each remaining row holds a torrent's values for those keys. This format is more efficient in terms of JSON generation and JSON parsing.

  2. If the request's ids field was recently-active, a removed array of torrent-id numbers of recently-removed torrents.

Note: For more information on what these fields mean, see the comments in libtransmission/transmission.h. The 'source' column here corresponds to the data structure there.

KeyValue Typetransmission.h source
activityDatenumbertr_stat
addedDatenumbertr_stat
availabilityarray (see below)tr_torrentAvailability()
bandwidthPrioritynumbertr_priority_t
commentstringtr_torrent_view
corruptEvernumbertr_stat
creatorstringtr_torrent_view
dateCreatednumbertr_torrent_view
desiredAvailablenumbertr_stat
doneDatenumbertr_stat
downloadDirstringtr_torrent
downloadedEvernumbertr_stat
downloadLimitnumbertr_torrent
downloadLimitedbooleantr_torrent
editDatenumbertr_stat
errornumbertr_stat
errorStringstringtr_stat
etanumbertr_stat
etaIdlenumbertr_stat
file-countnumbertr_info
filesarray (see below)n/a
fileStatsarray (see below)n/a
groupstringn/a
hashStringstringtr_torrent_view
haveUncheckednumbertr_stat
haveValidnumbertr_stat
honorsSessionLimitsbooleantr_torrent
idnumbertr_torrent
isFinishedbooleantr_stat
isPrivatebooleantr_torrent
isStalledbooleantr_stat
labelsarray of stringstr_torrent
leftUntilDonenumbertr_stat
magnetLinkstringn/a
manualAnnounceTimenumbertr_stat
maxConnectedPeersnumbertr_torrent
metadataPercentCompletedoubletr_stat
namestringtr_torrent_view
peer-limitnumbertr_torrent
peersarray (see below)n/a
peersConnectednumbertr_stat
peersFromobject (see below)n/a
peersGettingFromUsnumbertr_stat
peersSendingToUsnumbertr_stat
percentCompletedoubletr_stat
percentDonedoubletr_stat
piecesstring (see below)tr_torrent
pieceCountnumbertr_torrent_view
pieceSizenumbertr_torrent_view
prioritiesarray (see below)n/a
primary-mime-typestringtr_torrent
queuePositionnumbertr_stat
rateDownload (B/s)numbertr_stat
rateUpload (B/s)numbertr_stat
recheckProgressdoubletr_stat
secondsDownloadingnumbertr_stat
secondsSeedingnumbertr_stat
seedIdleLimitnumbertr_torrent
seedIdleModenumbertr_inactivelimit
seedRatioLimitdoubletr_torrent
seedRatioModenumbertr_ratiolimit
sequentialDownloadbooleantr_torrent
sizeWhenDonenumbertr_stat
startDatenumbertr_stat
statusnumber (see below)tr_stat
trackersarray (see below)n/a
trackerListstringstring of announce URLs, one per line, with a blank line between tiers
trackerStatsarray (see below)n/a
totalSizenumbertr_torrent_view
torrentFilestringtr_info
uploadedEvernumbertr_stat
uploadLimitnumbertr_torrent
uploadLimitedbooleantr_torrent
uploadRatiodoubletr_stat
wantedarray (see below)n/a
webseedsarray of stringstr_tracker_view
webseedsSendingToUsnumbertr_stat

availability: An array of pieceCountnumbers representing the number of connected peers that have each piece, or -1 if we already have the piece ourselves.

files: array of objects, each containing:

KeyValue Typetransmission.h source
bytesCompletednumbertr_file_view
lengthnumbertr_file_view
namestringtr_file_view

fileStats: a file's non-constant properties. An array of tr_info.filecount objects, each containing:

KeyValue Typetransmission.h source
bytesCompletednumbertr_file_view
wantednumbertr_file_view (Note: For backwards compatibility, this is serialized as an array of 0 or 1 that should be treated as booleans)
prioritynumbertr_file_view

peers: an array of objects, each containing:

KeyValue Typetransmission.h source
addressstringtr_peer_stat
clientNamestringtr_peer_stat
clientIsChokedbooleantr_peer_stat
clientIsInterestedbooleantr_peer_stat
flagStrstringtr_peer_stat
isDownloadingFrombooleantr_peer_stat
isEncryptedbooleantr_peer_stat
isIncomingbooleantr_peer_stat
isUploadingTobooleantr_peer_stat
isUTPbooleantr_peer_stat
peerIsChokedbooleantr_peer_stat
peerIsInterestedbooleantr_peer_stat
portnumbertr_peer_stat
progressdoubletr_peer_stat
rateToClient (B/s)numbertr_peer_stat
rateToPeer (B/s)numbertr_peer_stat

peersFrom: an object containing:

KeyValue Typetransmission.h source
fromCachenumbertr_stat
fromDhtnumbertr_stat
fromIncomingnumbertr_stat
fromLpdnumbertr_stat
fromLtepnumbertr_stat
fromPexnumbertr_stat
fromTrackernumbertr_stat

pieces: A bitfield holding pieceCount flags which are set to 'true' if we have the piece matching that position. JSON doesn't allow raw binary data, so this is a base64-encoded string. (Source: tr_torrent)

priorities: An array of tr_torrentFileCount() numbers. Each is the tr_priority_t mode for the corresponding file.

status: A number between 0 and 6, where:

ValueMeaning
0Torrent is stopped
1Torrent is queued to verify local data
2Torrent is verifying local data
3Torrent is queued to download
4Torrent is downloading
5Torrent is queued to seed
6Torrent is seeding

trackers: array of objects, each containing:

KeyValue Typetransmission.h source
announcestringtr_tracker_view
idnumbertr_tracker_view
scrapestringtr_tracker_view
sitenamestringtr_tracker_view
tiernumbertr_tracker_view

trackerStats: array of objects, each containing:

KeyValue Typetransmission.h source
announceStatenumbertr_tracker_view
announcestringtr_tracker_view
downloadCountnumbertr_tracker_view
hasAnnouncedbooleantr_tracker_view
hasScrapedbooleantr_tracker_view
hoststringtr_tracker_view
idnumbertr_tracker_view
isBackupbooleantr_tracker_view
lastAnnouncePeerCountnumbertr_tracker_view
lastAnnounceResultstringtr_tracker_view
lastAnnounceStartTimenumbertr_tracker_view
lastAnnounceSucceededbooleantr_tracker_view
lastAnnounceTimenumbertr_tracker_view
lastAnnounceTimedOutbooleantr_tracker_view
lastScrapeResultstringtr_tracker_view
lastScrapeStartTimenumbertr_tracker_view
lastScrapeSucceededbooleantr_tracker_view
lastScrapeTimenumbertr_tracker_view
lastScrapeTimedOutbooleantr_tracker_view
leecherCountnumbertr_tracker_view
nextAnnounceTimenumbertr_tracker_view
nextScrapeTimenumbertr_tracker_view
scrapeStatenumbertr_tracker_view
scrapestringtr_tracker_view
seederCountnumbertr_tracker_view
sitenamestringtr_tracker_view
tiernumbertr_tracker_view

wanted: An array of tr_torrentFileCount() Booleans true if the corresponding file is to be downloaded. (Source: tr_file_view)

Example:

Say we want to get the name and total size of torrents #7 and #10.

Request:

{
   "arguments": {
       "fields": [ "id", "name", "totalSize" ],
       "ids": [ 7, 10 ]
   },
   "method": "torrent-get",
   "tag": 39693
}

Response:

{
   "arguments": {
      "torrents": [
         {
             "id": 10,
             "name": "Fedora x86_64 DVD",
             "totalSize": 34983493932
         },
         {
             "id": 7,
             "name": "Ubuntu x86_64 DVD",
             "totalSize": 9923890123
         }
      ]
   },
   "result": "success",
   "tag": 39693
}

3.4 Adding a torrent

Method name: torrent-add

Request arguments:

KeyValue TypeDescription
cookiesstringpointer to a string of one or more cookies.
download-dirstringpath to download the torrent to
filenamestringfilename or URL of the .torrent file
labelsarrayarray of string labels
metainfostringbase64-encoded .torrent content
pausedbooleanif true, don't start the torrent
peer-limitnumbermaximum number of peers
bandwidthPrioritynumbertorrent's bandwidth tr_priority_t
files-wantedarrayindices of file(s) to download
files-unwantedarrayindices of file(s) to not download
priority-higharrayindices of high-priority file(s)
priority-lowarrayindices of low-priority file(s)
priority-normalarrayindices of normal-priority file(s)

Either filename or metainfo must be included. All other arguments are optional.

The format of the cookies should be NAME=CONTENTS, where NAME is the cookie name and CONTENTS is what the cookie should contain. Set multiple cookies like this: name1=content1; name2=content2; etc. See libcurl documentation for more information.

Response arguments:

  • On success, a torrent-added object in the form of one of 3.3's torrent objects with the fields for idname, and hashString.

  • When attempting to add a duplicate torrent, a torrent-duplicate object in the same form is returned, but the response's result value is still success.

3.5 Removing a torrent

Method name: torrent-remove

KeyValue TypeDescription
idsarraytorrent list, as described in 3.1
delete-local-databooleandelete local data. (default: false)

Response arguments: none

3.6 Moving a torrent

Method name: torrent-set-location

Request arguments:

KeyValue TypeDescription
idsarraytorrent list, as described in 3.1
locationstringthe new torrent location
movebooleanif true, move from previous location. otherwise, search "location" for files (default: false)

Response arguments: none

3.7 Renaming a torrent's path

Method name: torrent-rename-path

For more information on the use of this function, see the transmission.h documentation of tr_torrentRenamePath(). In particular, note that if this call succeeds you'll want to update the torrent's files and name field with torrent-get.

Request arguments:

KeyValue TypeDescription
idsarraythe torrent list, as described in 3.1 (must only be 1 torrent)
pathstringthe path to the file or folder that will be renamed
namestringthe file or folder's new name

Response arguments: pathname, and id, holding the torrent ID integer

4 Session requests

4.1 Session arguments

KeyValue TypeDescription
alt-speed-downnumbermax global download speed (KBps)
alt-speed-enabledbooleantrue means use the alt speeds
alt-speed-time-beginnumberwhen to turn on alt speeds (units: minutes after midnight)
alt-speed-time-daynumberwhat day(s) to turn on alt speeds (look at tr_sched_day)
alt-speed-time-enabledbooleantrue means the scheduled on/off times are used
alt-speed-time-endnumberwhen to turn off alt speeds (units: same)
alt-speed-upnumbermax global upload speed (KBps)
blocklist-enabledbooleantrue means enabled
blocklist-sizenumbernumber of rules in the blocklist
blocklist-urlstringlocation of the blocklist to use for blocklist-update
cache-size-mbnumbermaximum size of the disk cache (MB)
config-dirstringlocation of transmission's configuration directory
default-trackersstringannounce URLs, one per line, and a blank line between tiers.
dht-enabledbooleantrue means allow DHT in public torrents
download-dirstringdefault path to download torrents
download-dir-free-spacenumberDEPRECATEDUse the free-spacemethod instead.
download-queue-enabledbooleanif true, limit how many torrents can be downloaded at once
download-queue-sizenumbermax number of torrents to download at once (see download-queue-enabled)
encryptionstringrequiredpreferredtolerated
idle-seeding-limit-enabledbooleantrue if the seeding inactivity limit is honored by default
idle-seeding-limitnumbertorrents we're seeding will be stopped if they're idle for this long
incomplete-dir-enabledbooleantrue means keep torrents in incomplete-dir until done
incomplete-dirstringpath for incomplete torrents, when enabled
lpd-enabledbooleantrue means allow Local Peer Discovery in public torrents
peer-limit-globalnumbermaximum global number of peers
peer-limit-per-torrentnumbermaximum global number of peers
peer-port-random-on-startbooleantrue means pick a random peer port on launch
peer-portnumberport number
pex-enabledbooleantrue means allow PEX in public torrents
port-forwarding-enabledbooleantrue means ask upstream router to forward the configured peer port to transmission using UPnP or NAT-PMP
queue-stalled-enabledbooleanwhether or not to consider idle torrents as stalled
queue-stalled-minutesnumbertorrents that are idle for N minuets aren't counted toward seed-queue-size or download-queue-size
rename-partial-filesbooleantrue means append .part to incomplete files
rpc-version-minimumnumberthe minimum RPC API version supported
rpc-version-semverstringthe current RPC API version in a semver-compatible string
rpc-versionnumberthe current RPC API version
script-torrent-added-enabledbooleanwhether or not to call the added script
script-torrent-added-filenamestringfilename of the script to run
script-torrent-done-enabledbooleanwhether or not to call the done script
script-torrent-done-filenamestringfilename of the script to run
script-torrent-done-seeding-enabledbooleanwhether or not to call the seeding-done script
script-torrent-done-seeding-filenamestringfilename of the script to run
seed-queue-enabledbooleanif true, limit how many torrents can be uploaded at once
seed-queue-sizenumbermax number of torrents to uploaded at once (see seed-queue-enabled)
seedRatioLimitdoublethe default seed ratio for torrents to use
seedRatioLimitedbooleantrue if seedRatioLimit is honored by default
speed-limit-down-enabledbooleantrue means enabled
speed-limit-downnumbermax global download speed (KBps)
speed-limit-up-enabledbooleantrue means enabled
speed-limit-upnumbermax global upload speed (KBps)
start-added-torrentsbooleantrue means added torrents will be started right away
trash-original-torrent-filesbooleantrue means the .torrent file of added torrents will be deleted
unitsobjectsee below
utp-enabledbooleantrue means allow UTP
versionstringlong version string $version ($revision)

units: an object containing:

KeyValue Typetransmission.h source
speed-unitsarray4 strings: KB/s, MB/s, GB/s, TB/s
speed-bytesnumbernumber of bytes in a KB (1000 for kB; 1024 for KiB)
size-unitsarray4 strings: KB/s, MB/s, GB/s, TB/s
size-bytesnumbernumber of bytes in a KB (1000 for kB; 1024 for KiB)
memory-unitsarray4 strings: KB/s, MB/s, GB/s, TB/s
memory-bytesnumbernumber of bytes in a KB (1000 for kB; 1024 for KiB)

rpc-version indicates the RPC interface version supported by the RPC server. It is incremented when a new version of Transmission changes the RPC interface.

rpc-version-minimum indicates the oldest API supported by the RPC server. It is changes when a new version of Transmission changes the RPC interface in a way that is not backwards compatible. There are no plans for this to be common behavior.

4.1.1 Mutators

Method name: session-set

Request arguments: the mutable properties from 4.1's arguments, i.e. all of them except:

  • blocklist-size
  • config-dir
  • rpc-version-minimum,
  • rpc-version-semver
  • rpc-version
  • session-id
  • units
  • version

Response arguments: none

4.1.2 Accessors

Method name: session-get

Request arguments: an optional fields array of keys (see 4.1)

Response arguments: key/value pairs matching the request's fields argument if present, or all supported fields (see 4.1) otherwise.

4.2 Session statistics

Method name: session-stats

Request arguments: none

Response arguments:

KeyValue TypeDescription
activeTorrentCountnumber 
downloadSpeednumber 
pausedTorrentCountnumber 
torrentCountnumber 
uploadSpeednumber 
cumulative-statsstats object (see below) 
current-statsstats object (see below) 

A stats object contains:

KeyValue Typetransmission.h source
uploadedBytesnumbertr_session_stats
downloadedBytesnumbertr_session_stats
filesAddednumbertr_session_stats
sessionCountnumbertr_session_stats
secondsActivenumbertr_session_stats

4.3 Blocklist

Method name: blocklist-update

Request arguments: none

Response arguments: a number blocklist-size

4.4 Port checking

This method tests to see if your incoming peer port is accessible from the outside world.

Method name: port-test

Request arguments: none

Response arguments: a Boolean, port-is-open

4.5 Session shutdown

This method tells the transmission session to shut down.

Method name: session-close

Request arguments: none

Response arguments: none

4.6 Queue movement requests

Method nametransmission.h source
queue-move-toptr_torrentQueueMoveTop()
queue-move-uptr_torrentQueueMoveUp()
queue-move-downtr_torrentQueueMoveDown()
queue-move-bottomtr_torrentQueueMoveBottom()

Request arguments:

KeyValue TypeDescription
idsarraytorrent list, as described in 3.1.

Response arguments: none

4.7 Free space

This method tests how much free space is available in a client-specified folder.

Method name: free-space

Request arguments:

KeyValue typeDescription
pathstringthe directory to query

Response arguments:

KeyValue typeDescription
pathstringsame as the Request argument
size-bytesnumberthe size, in bytes, of the free space in that directory
total_sizenumberthe total capacity, in bytes, of that directory

4.8 Bandwidth groups

4.8.1 Bandwidth group mutator: group-set

Method name: group-set

Request parameters:

KeyValue typeDescription
honorsSessionLimitsbooleantrue if session upload limits are honored
namestringBandwidth group name
speed-limit-down-enabledbooleantrue means enabled
speed-limit-downnumbermax global download speed (KBps)
speed-limit-up-enabledbooleantrue means enabled
speed-limit-upnumbermax global upload speed (KBps)

Response arguments: none

4.8.2 Bandwidth group accessor: group-get

Method name: group-get

Request arguments: An optional argument groupgroup is either a string naming the bandwidth group, or a list of such strings. If group is omitted, all bandwidth groups are used.

Response arguments:

KeyValue typeDescription
grouparrayA list of bandwidth group description objects

A bandwidth group description object has:

KeyValue typeDescription
honorsSessionLimitsbooleantrue if session upload limits are honored
namestringBandwidth group name
speed-limit-down-enabledbooleantrue means enabled
speed-limit-downnumbermax global download speed (KBps)
speed-limit-up-enabledbooleantrue means enabled
speed-limit-upnumbermax global upload speed (KBps)

5 Protocol versions

This section lists the changes that have been made to the RPC protocol.

There are two ways to check for API compatibility. Since most developers knowsemver, session-get's rpc-version-semveris the recommended way. That value is a semver-compatible string of the RPC protocol version number.

Since Transmission predates the semver 1.0 spec, the previous scheme was for the RPC version to be a whole number and to increment it whenever a change was made. That is session-get's rpc-versionrpc-version-minimum lists the oldest version that is compatible with the current version; i.e. an app coded to use rpc-version-minimum would still work on a Transmission release runningrpc-version.

Breaking changes are denoted with a 💣emoji.

Transmission 1.30 (rpc-version-semver1.0.0, rpc-version: 1)

Initial revision.

Transmission 1.40 (rpc-version-semver1.1.0, rpc-version: 2)

MethodDescription
torrent-getnew port to peers

Transmission 1.41 (rpc-version-semver1.2.0, rpc-version: 3)

MethodDescription
session-getnew arg version
torrent-getnew arg downloaders
torrent-removenew method

Transmission 1.50 (rpc-version-semver1.3.0, rpc-version: 4)

MethodDescription
session-getnew arg rpc-version-minimum
session-getnew arg rpc-version
session-statsadded cumulative-stats
session-statsadded current-stats
torrent-getnew arg downloadDir

Transmission 1.60 (rpc-version-semver2.0.0, rpc-version: 5)

MethodDescription
session-get💣 renamed peer-limitto peer-limit-global
session-get💣 renamed pex-allowedto pex-enabled
session-get💣 renamed port to peer-port
torrent-get💣 removed arg downloadLimitMode
torrent-get💣 removed arg uploadLimitMode
torrent-set💣 renamed speed-limit-down-enabled to downloadLimited
torrent-set💣 renamed speed-limit-down to downloadLimit
torrent-set💣 renamed speed-limit-up-enabled to uploadLimited
torrent-set💣 renamed speed-limit-up to uploadLimit
blocklist-updatenew method
port-testnew method
session-getnew arg alt-speed-begin
session-getnew arg alt-speed-down
session-getnew arg alt-speed-enabled
session-getnew arg alt-speed-end
session-getnew arg alt-speed-time-enabled
session-getnew arg alt-speed-up
session-getnew arg blocklist-enabled
session-getnew arg blocklist-size
session-getnew arg peer-limit-per-torrent
session-getnew arg seedRatioLimit
session-getnew arg seedRatioLimited
torrent-addnew arg files-unwanted
torrent-addnew arg files-wanted
torrent-addnew arg priority-high
torrent-addnew arg priority-low
torrent-addnew arg priority-normal
torrent-getnew arg bandwidthPriority
torrent-getnew arg fileStats
torrent-getnew arg honorsSessionLimits
torrent-getnew arg percentDone
torrent-getnew arg pieces
torrent-getnew arg seedRatioLimit
torrent-getnew arg seedRatioMode
torrent-getnew arg torrentFile
torrent-getnew ids option recently-active
torrent-reannouncenew method
torrent-setnew arg bandwidthPriority
torrent-setnew arg honorsSessionLimits
torrent-setnew arg seedRatioLimit
torrent-setnew arg seedRatioLimited

Transmission 1.70 (rpc-version-semver2.1.0, rpc-version: 6)

MethodDescription
method torrent-set-locationnew method

Transmission 1.80 (rpc-version-semver3.0.0, rpc-version: 7)

MethodDescription
torrent-get💣 removed arg announceResponse (use trackerStats instead)
torrent-get💣 removed arg announceURL (use trackerStats instead)
torrent-get💣 removed arg downloaders (use trackerStats instead)
torrent-get💣 removed arg lastAnnounceTime (use trackerStats instead)
torrent-get💣 removed arg lastScrapeTime (use trackerStats instead)
torrent-get💣 removed arg leechers(use trackerStats instead)
torrent-get💣 removed arg nextAnnounceTime (use trackerStats instead)
torrent-get💣 removed arg nextScrapeTime (use trackerStats instead)
torrent-get💣 removed arg scrapeResponse (use trackerStats instead)
torrent-get💣 removed arg scrapeURL(use trackerStats instead)
torrent-get💣 removed arg seeders(use trackerStats instead)
torrent-get💣 removed arg swarmSpeed
torrent-get💣 removed arg timesCompleted (use trackerStats instead)
session-setnew arg incomplete-dir-enabled
session-setnew arg incomplete-dir
torrent-getnew arg magnetLink
torrent-getnew arg metadataPercentComplete
torrent-getnew arg trackerStats

Transmission 1.90 (rpc-version-semver3.1.0, rpc-version: 8)

MethodDescription
session-setnew arg rename-partial-files
session-getnew arg rename-partial-files
session-getnew arg config-dir
torrent-addnew arg bandwidthPriority
torrent-getnew trackerStats arg lastAnnounceTimedOut

Transmission 1.92 (rpc-version-semver3.2.0, rpc-version: 8)

Note: rpc-version was not bumped in this release due to an oversight.

MethodDescription
torrent-getnew trackerStats arg lastScrapeTimedOut

Transmission 2.00 (rpc-version-semver3.3.0, rpc-version: 9)

MethodDescription
session-setnew arg start-added-torrents
session-setnew arg trash-original-torrent-files
session-getnew arg start-added-torrents
session-getnew arg trash-original-torrent-files
torrent-getnew arg isFinished

Transmission 2.10 (rpc-version-semver3.4.0, rpc-version: 10)

MethodDescription
session-getnew arg cache-size-mb
session-getnew arg units
session-setnew arg idle-seeding-limit-enabled
session-setnew arg idle-seeding-limit
torrent-setnew arg seedIdleLimit
torrent-setnew arg seedIdleMode
torrent-setnew arg trackerAdd
torrent-setnew arg trackerRemove
torrent-setnew arg trackerReplace

Transmission 2.12 (rpc-version-semver3.5.0, rpc-version: 11)

MethodDescription
session-getnew arg blocklist-url
session-setnew arg blocklist-url

Transmission 2.20 (rpc-version-semver3.6.0, rpc-version: 12)

MethodDescription
session-getnew arg download-dir-free-space
session-closenew method

Transmission 2.30 (rpc-version-semver4.0.0, rpc-version: 13)

MethodDescription
torrent-get💣 removed arg peersKnown
session-getnew arg isUTP to the peers list
torrent-addnew arg cookies

Transmission 2.40 (rpc-version-semver5.0.0, rpc-version: 14)

MethodDescription
torrent-get💣 values of statusfield changed
queue-move-bottomnew method
queue-move-downnew method
queue-move-topnew method
session-setnew arg download-queue-enabled
session-setnew arg download-queue-size
session-setnew arg queue-stalled-enabled
session-setnew arg queue-stalled-minutes
session-setnew arg seed-queue-enabled
session-setnew arg seed-queue-size
torrent-getnew arg fromLpd in peersFrom
torrent-getnew arg isStalled
torrent-getnew arg queuePosition
torrent-setnew arg queuePosition
torrent-start-nownew method

Transmission 2.80 (rpc-version-semver5.1.0, rpc-version: 15)

MethodDescription
torrent-getnew arg etaIdle
torrent-rename-pathnew method
free-spacenew method
torrent-addnew return arg torrent-duplicate

Transmission 3.00 (rpc-version-semver5.2.0, rpc-version: 16)

MethodDescription
session-getnew request arg fields
session-getnew arg session-id
torrent-getnew arg labels
torrent-setnew arg labels
torrent-getnew arg editDate
torrent-getnew request arg format

Transmission 4.0.0 (rpc-version-semver5.3.0, rpc-version: 17)

MethodDescription
/upload⚠️ undocumented /uploadendpoint removed
session-get⚠️ DEPRECATEDdownload-dir-free-space. Use free-space instead.
free-spacenew return arg total_size
session-getnew arg default-trackers
session-getnew arg rpc-version-semver
session-getnew arg script-torrent-added-enabled
session-getnew arg script-torrent-added-filename
session-getnew arg script-torrent-done-seeding-enabled
session-getnew arg script-torrent-done-seeding-filename
torrent-addnew arg labels
torrent-getnew arg availability
torrent-getnew arg file-count
torrent-getnew arg group
torrent-getnew arg percentComplete
torrent-getnew arg primary-mime-type
torrent-getnew arg tracker.sitename
torrent-getnew arg trackerStats.sitename
torrent-getnew arg trackerList
torrent-setnew arg group
torrent-setnew arg trackerList
torrent-set⚠️ DEPRECATEDtrackerAdd. Use trackerList instead.
torrent-set⚠️ DEPRECATEDtrackerRemove. Use trackerList instead.
torrent-set⚠️ DEPRECATEDtrackerReplace. Use trackerList instead.
group-setnew method
group-getnew method
torrent-get⚠️ old arg wanted was implemented as an array of 0 or 1 in Transmission 3.00 and older, despite being documented as an array of booleans. Transmission 4.0.0 and 4.0.1 "fixed" this by returning an array of booleans; but in practical terms, this change caused an unannounced breaking change for any 3rd party code that expected 0 or 1. For this reason, 4.0.2 restored the 3.00 behavior and updated this spec to match the code.

Transmission 4.1.0 (rpc-version-semver5.4.0, rpc-version: 18)

MethodDescription
torrent-getnew arg sequentialDownload
torrent-setnew arg sequentialDownload
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值