yolo/arr
3
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects Releases Wiki Activity

Report Transmission's live state for arr's own grabs #263

New Issue
Closed
opened 2026-08-26 11:00:02 +01:00 by naps62-yolo · 0 comments
naps62-yolo commented 2026-08-26 11:00:02 +01:00
Owner
Copy Link
Copy Source

Nothing in the HTTP API reports a download. grabs records sent,
downloaded, imported, failed and vanished with no progress column —
correctly, per §8, where progress is transient state rebuilt from Transmission
— but no endpoint exposes even the existence of an in-flight grab. The UI
therefore cannot tell "this season pack is at 40%" from "nothing was ever
grabbed".

GET /api/downloads: one entry per grab whose infohash Transmission still
knows about, carrying

  • target_kind and target_id, so a caller can join it onto the row that
    owns the item
  • infohash and the torrent's name
  • a phase: downloading, stalled, errored, seeding, queued
  • percent complete, download rate, ETA

arr_dl::Torrent today carries progress, state, is_finished and
labels; rate, ETA and Transmission's error string are new fields on the
RPC call. AppState has no Transmission client — Syncer is the precedent
for putting one there (with_syncer / state.rs).

A torrent arr did not grab is never reported (§2, and the design amendment
in this milestone). The join is from grabs, not from Transmission's list.

Cache the snapshot with a short TTL. Every open page polls this on the UI's
existing cadence, and one RPC round trip per poll per client is the thing to
avoid — not the RPC itself, which the reconcile loop already makes every tick.

Non-goals: persisting any of it (no migration, no progress column), and any
control action — pause, resume, remove are Transmission's own UI.

Depends on: #262

Nothing in the HTTP API reports a download. `grabs` records `sent`, `downloaded`, `imported`, `failed` and `vanished` with no progress column — correctly, per §8, where progress is transient state rebuilt from Transmission — but no endpoint exposes even the existence of an in-flight grab. The UI therefore cannot tell "this season pack is at 40%" from "nothing was ever grabbed". `GET /api/downloads`: one entry per grab whose infohash Transmission still knows about, carrying - `target_kind` and `target_id`, so a caller can join it onto the row that owns the item - `infohash` and the torrent's name - a phase: downloading, stalled, errored, seeding, queued - percent complete, download rate, ETA `arr_dl::Torrent` today carries `progress`, `state`, `is_finished` and `labels`; rate, ETA and Transmission's error string are new fields on the RPC call. `AppState` has no Transmission client — `Syncer` is the precedent for putting one there (`with_syncer` / `state.rs`). **A torrent arr did not grab is never reported** (§2, and the design amendment in this milestone). The join is from `grabs`, not from Transmission's list. Cache the snapshot with a short TTL. Every open page polls this on the UI's existing cadence, and one RPC round trip per poll per client is the thing to avoid — not the RPC itself, which the reconcile loop already makes every tick. Non-goals: persisting any of it (no migration, no progress column), and any control action — pause, resume, remove are Transmission's own UI. Depends on: #262
naps62-yolo added this to the Download visibility milestone 2026-08-26 11:00:02 +01:00
naps62-yolo added the area/apidifficulty/moderatephase/5-uitype/feature labels 2026-08-26 11:00:03 +01:00
naps62-yolo added a new dependency 2026-08-26 11:00:35 +01:00
#262 Document the download surface in DESIGN.md
naps62-yolo added a new dependency 2026-08-26 11:00:35 +01:00
#264 Show live download state on movie, season and episode rows
naps62-yolo added a new dependency 2026-08-26 11:00:35 +01:00
#265 Let the next attempt supersede a season's import failure
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/api
arr-api
 area/ci
CI and test harness
 area/compat
arr-compat
 area/core
arr-core
 area/daemon
arr-daemon
 area/db
arr-db
 area/dl
arr-dl
 area/indexer
arr-indexer
 area/infra
workspace and tooling
 area/meta
arr-meta
 area/parse
arr-parse
 area/probe
arr-probe
 area/subs
arr-subs crate: providers, extraction, translation, sync
 area/web
web/
 difficulty/easy
bounded, obvious approach, few files
 difficulty/hard
subtle correctness or cross-cutting
 difficulty/moderate
multiple files, judgement, an interface to design
 difficulty/trivial
one file, mechanical, no design decisions
 phase/1-skeleton
workspace, CI, config, database, empty API and SPA
 phase/2-logic
parsing and policy engine, pure, no network
 phase/3-sourcing
TMDB and Prowlarr, read-only
 phase/4-movies
movies end to end
 phase/5-ui
search, buckets, library views, queues
 phase/6-tv
seasons, episodes, tracking, derived status
 phase/7-people
owner tags and notifications
 phase/8-compat
Jellyseerr shim
 phase/9-subtitles
build order: subtitles, DESIGN.md §15
 type/bug
type/chore
type/feature
type/test
No Label area/api difficulty/moderate phase/5-ui type/feature
Milestone
No items
No Milestone Download visibility
Projects
Clear projects
No project
Assignees
Clear assignees
hermes (Hermes (agent)) naps62 (Miguel Palhas) naps62-yolo (naps62-yolo (agent))
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Blocks
#264 Show live download state on movie, season and episode rows
yolo/arr
#265 Let the next attempt supersede a season's import failure
yolo/arr
Depends on
#262 Document the download surface in DESIGN.md
yolo/arr
Reference: yolo/arr#263
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?