qBittorrentMenu

Aplicación nativa para macOS que muestra las velocidades de descarga y subida de qBittorrent en la barra de menús. Al abrir el menú, también muestra el estado y hasta cinco transferencias activas.

La aplicación se conecta a la WebUI de qBittorrent en tu red y actualiza la información cada dos segundos.

Captura

Descargar

La versión más reciente está disponible en la sección Releases.

Instalación rápida

1. Descargá qBittorrentMenu-1.0.0.zip.
2. Descomprimilo.
3. Mové qBittorrentMenu.app a Applications.
4. Ejecutá la aplicación.
5. Configurá la conexión a tu qBittorrent siguiendo las instrucciones de este README.

Requisitos

• macOS 13 (Ventura) o posterior.
• Xcode o las herramientas de línea de comandos de Xcode con Swift 6.
• qBittorrent con la WebUI activada y accesible desde tu Mac.

Instalación y ejecución

1. Cloná el repositorio y entrá a la carpeta:

   git clone https://github.com/TU_USUARIO/qBittorrentMenu.git
   cd qBittorrentMenu

2. Creá tu configuración local a partir de la plantilla:

   cp Config.example.swift Sources/qBittorrentMenu/Config.swift

3. Editá Sources/qBittorrentMenu/Config.swift y completá la dirección de la WebUI, el usuario y la contraseña de qBittorrent. Por ejemplo, usá la dirección privada de tu red local; no una dirección pública.

4. Compilá y ejecutá la app:

   swift run qBittorrentMenu

La aplicación queda como un ítem de barra de menús y no muestra icono en el Dock. Para cerrarla, elegí Salir desde su menú.

También podés abrir Package.swift con Xcode, seleccionar el esquema qBittorrentMenu y presionar Run.

Compilación de distribución local

Para generar el ejecutable optimizado:

swift build -c release

El binario queda en .build/release/qBittorrentMenu. Este proyecto es un Swift Package ejecutable; no genera un .app firmado ni notarizado.

Configurar qBittorrent

En qBittorrent, activá la WebUI y verificá que la dirección, puerto, usuario y contraseña coincidan con Config.swift. Si qBittorrent se ejecuta en otro equipo, permití el acceso solo desde tu red local o VPN de confianza.

Seguridad

Sources/qBittorrentMenu/Config.swift está en .gitignore y no debe versionarse. La plantilla Config.example.swift contiene únicamente marcadores de posición.

• No publiques ni pegues en GitHub contraseñas, API keys, tokens, URLs con credenciales, archivos .env, certificados o claves privadas.
• Antes de hacer git add, revisá git status y confirmá que Config.swift no aparezca entre los archivos a subir.
• Si alguna credencial llega a un commit o a un issue, revocala o cambiala de inmediato. Eliminarla en un commit posterior no la elimina del historial público.
• No expongas la WebUI de qBittorrent directamente a Internet. Preferí LAN privada, firewall y/o VPN.

La versión actual usa el inicio de sesión de la WebUI (usuario y contraseña) y una cookie de sesión; no requiere ni incluye una API key.

Desarrollo

Ejecutá los tests con:

swift test

Los directorios de compilación, ajustes locales de Xcode y archivos de credenciales se excluyen del repositorio mediante .gitignore.

Licencia

Este proyecto está disponible bajo la Licencia MIT.

Esto permite usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y vender copias del software, sujeto a los términos de la licencia.