Seedbox Card
Transmission, qBittorrent and Deluge: speeds, torrents and the alternative speed.
Cards to monitor and control torrent clients: download and upload speeds with their 24-hour curves, torrent counters, the torrents list with resume and pause, and the alternative speed.
Highlights
- Transmission, qBittorrent and Deluge, several clients mixed
- Download and upload speeds, with their curves over 24 hours
- Active, downloading, seeding, paused and in error counters, global ratio
- Torrents list with progress, time left, search, resume and pause
- Resume all, pause all and alternative speed buttons
- Mini card with a detail button showing the full card
Cards
type: custom:seedbox-cardInstall
- 1Open the repository in the Marketplace with the Add to Marketplace button above, or add
github.com/juju35/ha-seedbox-cardas a custom repository (category Dashboard). - 2Download it from the Marketplace.
- 3Reload the browser and add the card from the dashboard editor.
Gallery 12
Documentation
From the README Features
Features
- Two cards: a full Seedbox Card and a compact Seedbox Mini Card
- Automatic discovery of the Transmission, qBittorrent and Deluge clients (several of each supported, and mixed)
- Download (green) and upload (blue) speeds, with the qBittorrent speed limits or the total transferred
- Speeds over the last 24 hours, drawn behind the speed tiles and, on the mini card, behind the speed rows, on a real time axis: missing data shows as a gap; their lowest and highest values in the tooltip
- Header status: idle, downloading, seeding, or both; qBittorrent's connection when it is firewalled or disconnected
- Torrent counters: active, downloading, seeding, paused, inactive, completed, errors (in red), total, and the global ratio
- Resume all / pause all (Transmission, Deluge; pausing asks for confirmation) and alternative speed (Transmission's turtle mode, qBittorrent) buttons
- Torrents list (Transmission, qBittorrent) with progress, status, time left and ratio, a search field (filters by name), torrents in error first; resume / pause of each Transmission torrent (pausing asks for confirmation)
- Free space of the download folder in the subtitle (Transmission)
- Click any value to open its Home Assistant history (more-info dialog)
- Detail button at the top right of the mini card: it switches to the full card and back; a click anywhere outside the card brings the compact view back
- Visual editor in the dashboard UI for both cards (no YAML needed)
- Light and dark mode; English, French, German, Spanish, Serbian (Cyrillic and Latin), Italian, Dutch, European Portuguese, Polish, Romanian, Danish, Swedish, Bulgarian, Russian, Ukrainian, Hungarian, Slovak, Czech, Slovenian, Latvian and Greek
- Single file, no external dependency
Supported integrations
Supported integrations
| Integration | What the cards show |
|---|---|
| Status, speeds and totals transferred, free space, active, paused, completed and total torrents, ratio, resume / pause all, turtle mode, torrents list with resume / pause. Details in Transmission | |
| Status and connection, speeds and their limits, active, inactive, paused, errored and total torrents, ratio, alternative speed, torrents list (read only). Details in qBittorrent | |
| Status, speeds, downloading and seeding torrents, resume / pause all. Details in Deluge |
Several clients are supported, and they can be mixed: each one shows in the editor's client list.
Prerequisites
Prerequisites
Home Assistant 2024.8 or later, and the Transmission, qBittorrent or Deluge integration (all built into Home Assistant), installed and configured.
Configuration
Configuration
Visual editor#
Edit a dashboard, click Add card and search for Seedbox Card or Seedbox Mini Card. The first client is preselected; pick another one in the list if you have several, set an optional title, choose the sections to display and the language. The preview updates live, and options left at their default are kept out of the generated YAML.
Minimal#
type: custom:seedbox-card
type: custom:seedbox-mini-card
Full options#
type: custom:seedbox-card
client: Seedbox
title: Seedbox
url: http://192.168.1.10:9091
show_title: true
show_subtitle: true
show_speeds: true
show_history: true
show_counts: true
show_controls: true
show_torrents: true
expand_torrents: false
language: fr
type: custom:seedbox-mini-card
client: Seedbox
title: Seedbox
url: http://192.168.1.10:9091
show_history: true
show_footer: true
zoom: true
language: fr
Options reference#
| Option | Card | Default | Description |
|---|---|---|---|
client |
both | First client | Torrent client to display: its device name (as shown in Home Assistant) or its device id (set by the visual editor) |
title |
both | Client name | Card title |
show_title |
both | true |
Show the title in the header (e.g. false under a section heading of your own) |
show_subtitle |
both | true |
Show the subtitle (client, free space) under the title |
url |
both | Detected | Address opened in a new tab when clicking the header icon. Defaults to the web UI known by the integration (Deluge), else the client's website |
show_speeds |
full | true |
Download and upload speed tiles |
show_history |
both | true |
Speeds of the last 24 hours, from the recorder's history averaged over 5-minute periods, placed on a 24 h time axis with a gap where data is missing. Full card: behind the speed tiles; mini card: behind the speed rows |
show_counts |
full | true |
Torrent counters and global ratio |
show_controls |
full | true |
Resume all / pause all and alternative speed buttons, and the resume / pause button of each Transmission torrent |
show_torrents |
full | true |
Torrents list (Transmission and qBittorrent) |
expand_torrents |
full | false |
Torrents list expanded when the card loads (click the section title to fold / unfold) |
show_footer |
mini | true |
Torrent counters, ratio and alternative speed in the footer |
zoom |
mini | true |
Detail button at the top right: switches to the full card and back (false removes it) |
language |
both | Auto | Force language: en, fr, de, es, sr, sr-Latn, it, nl, pt, pl, ro, da, sv, bg, ru, uk, hu, sk, cs, sl, lv or el (auto-detects from HA settings) |
Transmission
Transmission
| Card | Transmission |
|---|---|
| Header | Status, free space of the download folder |
| Speed tiles | Download and upload speeds, total downloaded and uploaded |
| Counters | Active, paused, completed and total torrents, total ratio |
| Buttons | Switch (resume / pause all) and Turtle mode (alternative speed) |
| Torrents list | The torrent_info attribute of the Total torrents sensor; resume / pause through the transmission.start_torrent and transmission.stop_torrent actions |
The list shows as many torrents as the integration's Limit option allows (10 by default, in the integration's options, with their order).
qBittorrent
qBittorrent
| Card | qBittorrent |
|---|---|
| Header | Status; the connection status instead when it is firewalled (orange) or disconnected (red) |
| Speed tiles | Download and upload speeds and their limits (no limit: the total transferred) |
| Counters | Active, inactive, paused, errored and total torrents, global ratio |
| Buttons | Alternative speed |
| Torrents list | The qbittorrent.get_torrents action, read when the list is opened and again every minute while it stays open |
The integration has no action to resume or pause a torrent: the list is read only, and there is no resume all / pause all button. Some of its sensors are disabled by default (speed limits, totals, ratio): enable them in Home Assistant to show them.
Deluge
Deluge
| Card | Deluge |
|---|---|
| Header | Status; the icon opens the Deluge web UI |
| Speed tiles | Download and upload speeds |
| Counters | Downloading and seeding torrents |
| Buttons | The integration's switch (resume / pause all) |
Deluge exposes no torrent list nor alternative speed in Home Assistant: those parts are left out.
How it works
How it works
The cards read the Home Assistant entity and device registries instead of entity ids: every entity of the Transmission, qBittorrent and Deluge integrations is matched by its translation_key (download_speed, active_torrents, turtle_mode…) and grouped by the client's device. Entity ids can therefore be in any language or renamed without breaking the cards.
Speeds are shown in decimal units (kB/s, MB/s, one decimal under 100) whatever unit Home Assistant displays them in; sizes in binary units (GiB, TiB). The speed sensors have no long-term statistics, so the 24 h curves come from the recorder's history, averaged over 5-minute periods and fetched again every 5 minutes. On the mini card, a speed bar is scaled on the speed limit (qBittorrent), else on the highest speed of the last 24 hours.
Pausing every torrent or a single torrent asks for confirmation, in a popup at the top of the card; resuming and switching the alternative speed act at once.
Changelog
CHANGELOG.md 1.0.0Nov 13, 2026Latest
Features
- Seedbox Card and Seedbox Mini Card for the torrent clients of Home Assistant core: Transmission, qBittorrent and Deluge, found through the entity and device registries (several clients, mixed, whatever the language or entity ids).
- Download and upload speeds in decimal units (
kB/s,MB/s), download in green and upload in blue, with qBittorrent's speed limits or the total transferred, and their curves over the last 24 hours (recorder history averaged over 5-minute periods, gaps where data is missing). - Header status (idle, downloading, seeding, both), qBittorrent's connection when firewalled or disconnected, free space of Transmission's download folder.
- Torrent counters (active, downloading, seeding, paused, inactive, completed, errors, total) and global ratio.
- Resume all / pause all (Transmission, Deluge; pausing asks for confirmation) and alternative speed (Transmission's turtle mode, qBittorrent) buttons.
- Torrents list with progress, status, time left and ratio, a search field, torrents in error first: Transmission's
torrent_infoattribute with resume / pause of each torrent, qBittorrent'sget_torrentsaction (read only). - Mini card: speed and active torrents rows, counters in the footer, detail button switching to the full card and back.
- Visual editors, light and dark themes, 22 languages loaded on demand.