This Go app acts as a lightweight proxy API for qBittorrent. It logs into your qBittorrent Web UI, fetches torrent info, caches it for 5 minutes, and exposes a simple authenticated HTTP endpoint to get torrent data in JSON format.
docker-compose.yml
services:
qbwrapper:
container_name: qbwrapper
image: ghcr.io/panonim/qbwrapper:latest
ports:
- "9911:9911"
environment:
TZ: Set/Me
USERNAME: ${QB_USERNAME}
PASSWORD: ${QB_PASSWORD}
BASE_URL: ${QB_URL}
AUTH_TOKEN: ${AUTH_TOKEN}
LISTEN_PORT: "9911"
RATE_LIMIT: "10" # API requests per minute (default: 10)
restart: unless-stopped.env
QB_USERNAME=
QB_PASSWORD=
QB_URL=https://IP:PORT
AUTH_TOKEN=REPLACEMEYou must provide these in a .env file or your environment:
QB_URL— base URL of your qBittorrent Web UI (e.g.,https://localhost:8080)QB_USERNAME— your qBittorrent usernameQB_PASSWORD— your qBittorrent passwordAUTH_TOKEN— Bearer token required to access the/qb/torrentsendpoint
- type: custom-api
title: qBittorrent
cache: 15m
options:
always-show-stats: false
subrequests:
info:
url: "https://${QB_URL}/qb/torrents"
method: GET
headers:
Authorization: "Bearer ${AUTH_TOKEN}" # your token
template: |
{{ $info := .Subrequest "info" }}
{{ $torrents := $info.JSON.Array "" }}
{{ $alwaysShowStats := .Options.BoolOr "always-show-stats" false }}
{{ if eq (len $torrents) 0 }}
<div>No torrents found.</div>
{{ else }}
{{ range $t := $torrents }}
{{ $state := $t.String "state" }}
{{ $downloaded := $t.Int "downloaded" }}
{{ $size := $t.Int "size" }}
{{ $icon := "❔" }}
{{ if ge $downloaded $size }}
{{ $icon = "✅" }}
{{ else if or (eq $state "downloading") (eq $state "forcedDL") }}
{{ $icon = "⬇️" }}
{{ else if or (eq $state "uploading") (eq $state "forcedUP") }}
{{ $icon = "⬆️" }}
{{ else if or (eq $state "pausedDL") (eq $state "stoppedDL") (eq $state "pausedUP") (eq $state "stalledDL") (eq $state "stalledUP") (eq $state "queuedDL") (eq $state "queuedUP") }}
{{ $icon = "⏸️" }}
{{ else if or (eq $state "error") (eq $state "missingFiles") }}
{{ $icon = "❗" }}
{{ else if eq $state "checkingDL" }}
{{ $icon = "🔍" }}
{{ else if eq $state "checkingUP" }}
{{ $icon = "🔎" }}
{{ else if eq $state "allocating" }}
{{ $icon = "⚙️" }}
{{ else if eq $state "checkingResumeData" }}
{{ $icon = "♻️" }}
{{ end }}
{{ $name := $t.String "name" }}
{{ $shortName := $name }}
{{ if gt (len $name) 20 }}
{{ $shortName = printf "%s..." (slice $name 0 20) }}
{{ end }}
{{ $progress := mul ($t.Float "progress") 100 }}
{{ $downloaded := $t.Int "downloaded" }}
{{ $size := $t.Int "size" }}
{{ $fmtDownloaded := "" }}
{{ $fmtSize := "" }}
{{ if gt $size 1073741824 }}
{{ $fmtDownloaded = printf "%.2f GB" (div (toFloat $downloaded) 1073741824) }}
{{ $fmtSize = printf "%.2f GB" (div (toFloat $size) 1073741824) }}
{{ else }}
{{ $fmtDownloaded = printf "%.2f MB" (div (toFloat $downloaded) 1048576) }}
{{ $fmtSize = printf "%.2f MB" (div (toFloat $size) 1048576) }}
{{ end }}
{{ $eta := $t.Int "eta" }}
{{ $etaStr := "" }}
{{ if gt $eta 0 }}
{{ $h := div $eta 3600 }}
{{ $m := div (mod $eta 3600) 60 }}
{{ $etaStr = printf "%dh %dm" $h $m }}
{{ else if eq $eta 0 }}
{{ $etaStr = "0m" }}
{{ else }}
{{ $etaStr = "∞" }}
{{ end }}
{{ $category := "None" }}
{{ if and ($t.Exists "category") (ne ($t.String "category") "") }}
{{ $category = $t.String "category" }}
{{ end }}
{{ $numLeechs := 0 }}
{{ if $t.Exists "num_leechs" }}
{{ $numLeechs = $t.Int "num_leechs" }}
{{ end }}
{{ $numSeeds := 0 }}
{{ if $t.Exists "num_seeds" }}
{{ $numSeeds = $t.Int "num_seeds" }}
{{ end }}
<div>
<h2 style="font-size: 1.2em;">{{ $icon }} {{ $shortName }}</h2>
{{ if $alwaysShowStats }}
<hr/>
<div>
<div>Progress: {{ printf "%.1f%%" $progress }}</div>
<div>Downloaded: {{ $fmtDownloaded }} / {{ $fmtSize }}</div>
<div>Category: {{ $category }}</div>
<div>Leechs: {{ $numLeechs }}, Seeds: {{ $numSeeds }}</div>
<div>ETA: {{ $etaStr }}</div>
</div>
{{ else }}
<details>
<summary>Show Stats</summary>
<div>Progress: {{ printf "%.1f%%" $progress }}</div>
<div>Downloaded: {{ $fmtDownloaded }} GB / {{ $fmtSize }} GB</div>
<div>Category: {{ $category }}</div>
<div>Leechs: {{ $numLeechs }}, Seeds: {{ $numSeeds }}</div>
<div>ETA: {{ $etaStr }}</div>
</details>
{{ end }}
</div>
{{ end }}
{{ end }}
You can put this app in the same place as glance and the same .env file, but in case you are using it alone please put this in your .env.
QB_URL— base URL of your qBittorrent Web UI (e.g.,https://localhost:8080)AUTH_TOKEN— Bearer token required to access the/qb/torrentsendpoin
Each torrent object includes:
name: Torrent namecategory: Assigned category in qBittorrentnum_leechs: Number of leechersnum_seeds: Number of seedersprogress: Download progress (0 to 1)state: Torrent state (e.g., downloading, paused)size: Total size in bytesdownloaded: Bytes downloaded so fareta: Estimated time remaining in seconds
- The cache is locked for concurrency safety.
- If the qBittorrent login fails, the app exits.
- If you hit the endpoint without a valid token, you get a 401 Unauthorized.
- The app uses standard Go HTTP server and
github.com/joho/godotenvfor env loading.