A single torrent as returned by torrents/info (see ext/api-map.md §3).
This model is also the value type of the torrents object in
sync/maindata, where qBittorrent sends partial TorrentInfo deltas
carrying only the fields that changed since the last response id. To make
that reuse safe, every field here is nilable — any subset of keys must
parse without raising — and JSON::Serializable::Unmapped is included so
keys not modelled here (forward drift on newer builds) are preserved in
#json_unmapped rather than rejected.
Byte counts, epoch timestamps and durations are Int64? (torrents can be
larger than 2 GiB and epoch seconds are fine in Int32 today but Int64 is
future-proof); fractional fields (progress, ratio, availability, the
ratio limits) are Float64?. state decodes through the tolerant
TorrentStateConverter, so an unknown/null state becomes nil instead
of raising.
Instance methods
added_on
Epoch seconds when the torrent was added.
amount_left
Bytes remaining to download.
auto_tmm
Whether automatic torrent management (auto-TMM) is enabled.
availability
Fractional availability of the torrent's pieces (may exceed 1.0).
category
Category name (empty string when uncategorised).
completed
Amount of the selected data already completed, in bytes.
completion_on
Epoch seconds when the torrent completed downloading.
content_path
Absolute path of the content (root of a multi-file torrent, or the file
itself for a single-file torrent).
dl_limit
Per-torrent download limit, bytes/s (-1 = unlimited).
dlspeed
Current download speed, bytes/s.
download_path
Incomplete-files (download) path (qB 5.x).
downloaded
Total bytes downloaded (all time for this torrent).
downloaded_session
Bytes downloaded this session.
eta
Estimated time to completion, seconds (8640000 = infinity).
f_l_piece_prio
Whether the first and last pieces are prioritised.
force_start
Whether force-start is enabled.
hash
Torrent hash (BitTorrent v1 infohash by default). Primary key of the
torrent across every endpoint.
infohash_v1
BitTorrent v1 infohash (qB 5.x).
infohash_v2
BitTorrent v2 infohash (qB 5.x; empty when the torrent has none).
is_private
Whether the torrent belongs to a private tracker (qB 5.x).
last_activity
Epoch seconds of the last upload/download activity.
magnet_uri
Magnet link for the torrent.
max_ratio
Per-torrent maximum ratio limit.
max_seeding_time
Per-torrent maximum seeding time, seconds.
num_complete
Seeders in the swarm as reported by trackers.
num_incomplete
Leechers in the swarm as reported by trackers.
num_leechs
Currently connected leechers.
num_seeds
Currently connected seeds.
priority
Queue position (-1 when queueing is off or the torrent is seeding).
progress
Download progress, 0.0–1.0.
ratio
Share ratio (capped around 9999).
ratio_limit
Per-torrent ratio limit (-2 = use global, -1 = no limit).
reannounce
Seconds until the next tracker announce (qB 5.x, not always present).
save_path
Save path for the torrent's data.
seeding_time_limit
Per-torrent seeding-time limit, minutes (-2 = global, -1 = none).
seen_complete
Epoch seconds the torrent was last seen complete in the swarm.
seq_dl
Whether sequential download is enabled.
size
Selected size in bytes (excludes files set to "do not download").
state
Current torrent state. Decoded tolerantly (unknown/null => nil).
super_seeding
Whether super-seeding is enabled.
time_active
Seconds the torrent has been active.
total_size
Total size in bytes including unselected files.
tracker
First working tracker URL (empty when none is working).
up_limit
Per-torrent upload limit, bytes/s (-1 = unlimited).
uploaded
Total bytes uploaded (all time for this torrent).
uploaded_session
Bytes uploaded this session.
upspeed
Current upload speed, bytes/s.