A closer look

qbtmud

An alternative qBittorrent WebUI with themes, guided setup, browser notifications and an installable app experience.

Background

Why I started it

Managing qBittorrent from a phone should be as practical as using it on a desktop. I wanted an interface that made everyday torrent management easier on both.

I built qbtmud as a replacement for the default WebUI, keeping the familiar qBittorrent workflows and adding customisation and browser integration.

The work

What it offers

Everyday torrent management

Add and manage torrents, inspect files and peers, and work with categories, tags, RSS and client settings.

Themes and personalisation

Choose or edit themes, follow guided first-run setup and keep layout and table preferences between visits.

Browser and Docker integration

Install the interface as a web app, register magnet links and configure notifications. A prebuilt Docker image includes qBittorrent with qbtmud enabled.

Implementation

Engineering choices

01

Keep familiar workflows

Use the qBittorrent Web API and preserve the operations people expect from the default interface.

02

Support different screen sizes

Make navigation and controls work with touch as well as a mouse, across desktop, tablet and phone.

03

Offer a choice of setup

Support existing qBittorrent installations as an alternative WebUI, or provide a Docker image with the interface already configured.

Current status

Where it stands

Available as a release archive for existing qBittorrent installations or as a Docker image with qBittorrent included. See the documentation for setup and hosting options.