macmenuqbt 0.1.0

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 menubarqbt
   

---

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
)

Screenshots

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