---
title: "Homarr Download Client Widget — Torrent & Usenet Monitor"
aliases: [homarr-downloads, homarr-torrent-widget, homarr-usenet-widget]
tags: [homarr, homelab, widgets, torrent, usenet, downloads]
sources: [raw/Download Client  Homarr documentation.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

The Download Client widget displays and manages active downloads from Torrent and Usenet clients directly inside a Homarr board. Shows progress, speed, ratio, and allows pause/resume/delete actions without leaving the dashboard.

## Supported Integrations

| Client | Type | Notes |
|--------|------|-------|
| SABnzbd | Usenet | Open Source Binary Newsreader |
| NZBGet | Usenet | Lightweight and efficient |
| Deluge | Torrent | Lightweight, cross-platform |
| Transmission | Torrent | Fast and free |
| qBittorrent | Torrent | Free and open-source |
| slskd | Soulseek | Client-server for Soulseek network |

## Interactions

- **Pause / Resume** a single download via its row icon
- **Delete** a download via the trash icon (optionally deletes files too)
- **Pause / Resume all** via the bottom bar button

## Configuration Options

| Option | Default | Notes |
|--------|---------|-------|
| Columns to show | integration, name, progress, time, actions | Full list: id, actions, added, category, downSpeed, index, integration, name, progress, ratio, received, sent, size, state, time, type, upSpeed |
| Enable items sorting | no | Clickable column headers |
| Default sort column | type | Any column except id/actions |
| Invert sorting | no | Reverses sort order |
| Show completed usenet entries | yes | Toggle per client type |
| Show completed torrent entries | yes | Toggle per client type |
| Show completed misc entries | yes | Toggle per client type |
| Hide completed torrents below speed threshold | 0 (disabled) | Value in KiB/s; useful to hide stalled seeders |
| Categories/names filter | — | Comma-separated; can act as whitelist or blacklist |
| Filter as whitelist | no | If yes: only matching items shown |
| Use filter to calculate Ratio | yes | Ratio stat reflects filtered set only |
| Limit items per integration | 50 | Per-integration cap, not global |

## Key Takeaways

- Supports **6 clients** across three protocols: Torrent (Deluge, Transmission, qBittorrent), Usenet (SABnzbd, NZBGet), and Soulseek (slskd)
- **Pause/resume/delete** controls are inline — no need to open the client UI
- The **speed threshold filter** (`Hide completed torrent under N KiB/s`) is the cleanest way to suppress finished-but-seeding entries without hiding them globally
- **Filter whitelist mode** flips the comma-separated filter from a blacklist to a whitelist — useful for focusing on specific categories
- Columns are fully configurable; default view is minimal (5 columns out of 17)
- Items are capped **per integration** (default 50), not globally — a board with 3 torrent clients could show up to 150 rows

## Adding the Widget

Follow the standard widget-add flow in Homarr. See [[wiki/homelab/homarr-boards|Homarr Boards]] for board editing basics and [[wiki/homelab/homarr-integrations|Homarr Integrations]] to connect a download client first.

## Related

- [[wiki/homelab/homarr-integrations|Homarr Integrations]] — connect SABnzbd, qBittorrent, etc. before using this widget
- [[wiki/homelab/homarr-boards|Homarr Boards]] — add and arrange widgets on boards
- [[wiki/homelab/homarr-tasks|Homarr Tasks]] — background jobs that drive real-time widget data refresh
- [[wiki/homelab/homarr-docker-stats|Homarr Docker Stats Widget]] — similar table-style widget for container monitoring

## Sources

- `raw/Download Client  Homarr documentation.md` (Homarr v1.59.2 docs)
