macmenuqbt 0.1.3

macOS menu bar app to show qBittorrent torrents status.

MacMenu-qBittorrent 🍏

MacMenu-qBittorrent is a lightweight macOS menu bar app that connects to qBittorrent's Web UI and displays active torrents with their progress directly in your Mac menu bar.

---

Features

• Runs natively on macOS as a menu bar application.
• Connects to qBittorrent Web UI via qbittorrent-api.
• Displays all active torrents with progress percentages in the menu bar.
• Auto-refreshes torrent status at configurable intervals.
• Configurable connection parameters (host, port, username, password).
• Simple and clean UI using rumps.

---

Installation via PyPI

1. Ensure you have Python >=3.8 installed on your Mac

2. Install the package from PyPI

   pip install macmenuqbt
   

---

Usage from the command line

Run the app from your terminal (or create a shortcut) — this will start the menu bar app:

macmenuqbt
# or the alias
mmqbt

Available options:

macmenuqbt --host localhost --port 8080 --username admin --password 123456 --interval 5

Argument	Alias(s)	Description	Default Value
--host	-H	qBittorrent Web UI host	localhost
--port	-P	qBittorrent Web UI port	8080
--username	-U	qBittorrent Web UI username	admin
--password	-PSW	qBittorrent Web UI password	123456
--interval	-I	Update interval in seconds	5
--version	-V	Show program version and exit
--help		Show this help message and exit

For help and version:

macmenuqbt --help
macmenuqbt --version

Usage as a Python module

You can also embed Menubar-qBittorrent in your own Python scripts by calling its main() function with parameters:

from macmenuqbt.core import main as mmqbt

mmqbt(
    host="localhost",
    port=8080,
    username="admin",
    password="123456",
    interval=5
)

What did you see

Name of torrent | Status Progression | ⬇️ DL speed ⬆️ UP speed | ⏳ ETA

Status	Emoji	Description
downloading	⬇️	Downloading
resumed	⬇️	Download resumed
running	⬇️	Running / in progress
forcedDL	⬇️	Forced download
seeding	🌱	Seeding (uploading)
completed	✅	Download completed
paused	⏸️	Paused
stopped	⏸️	Stopped
inactive	⏸️	Inactive
active	🔄	Active / operation in progress
stalled	⚠️	Stalled / waiting
stalled_uploading	⚠️	Upload stalled
stalled_downloading	⚠️	Download stalled
checking	🔍	Checking files
moving	📦	Moving files
errored	❌	Error encountered
all	📋	All torrents
unknown	❓	Unknown status

Notes

Only compatible with macOS due to use of rumps for menu bar integration.

Tested with Python 3.8+ and qBittorrent Web UI 5.x.

Requires qBittorrent Web UI to be enabled and accessible.

Disclaimer

This tool only displays torrent information; it does not modify or control qBittorrent.

Contributing

Feel free to open issues or submit pull requests!

Another qBittorrent plugin

• TrackersRemover-qBittorent: as expected