v0.1.0-alpha

v0.1.0-alpha

This is the first public alpha release of qbcli — a command-line tool to interact with the qBittorrent WebUI via its API.

qbcli was created as a weekend project to:

• Automate port management and other settings on qBittorrent
• Handle authentication and session cookie management
• Retry gracefully on transient network errors (e.g., timeouts, connection refused)
• Provide a clean CLI interface using Cobra

Features

• Login and session handling (cookie-based)
• Retry support for transient HTTP failures
• Subcommands to:
  • Set preferences (JSON-based)
  • Get/set listening ports
  • Manage authentication state
• Dockerized using Gluetun as the base image
• Builds and publishes to GitHub Container Registry (GHCR)

Docker Image

The image is available at:

ghcr.io/gstos/gluetun_qbcli:v0.1.0-alpha

Run it with your preferred configuration and Gluetun VPN settings.

Disclaimers

This is an alpha release — expect rough edges. It was built mainly to learn and experiment with:

• Go's net/http and error handling
• Retry and backoff strategies
• slog structured logging
• GitHub Actions for Docker publishing

Use at your own risk. Suggestions, issues, and PRs are welcome!