Skip to content

Releases: gstos/qbcli

v0.1.1-alpha

v0.1.1-alpha Pre-release
Pre-release

Choose a tag to compare

@gstos gstos released this 02 Jun 17:54
  • Fixed wrong behavior of failed authentication not waiting delay time
  • Split log output to stdout for info and debug logs instead of stderr
  • Minor fixes in docker-compose.yml

v0.1.0-alpha

v0.1.0-alpha Pre-release
Pre-release

Choose a tag to compare

@gstos gstos released this 02 Jun 15:57

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!