feat: add interactive torrent management with inline buttons and improved list formatting

- Add inline keyboard to /qtorrents with action buttons (Refresh, Pause All, Resume All, Details)
- Implement callback query processing for button interactions with instant feedback
- Add pause_torrent, resume_torrent, delete_torrent, and get_torrent_info functions to qbittorrent_api
- Improve torrent list formatting with categorization (Active, Paused, Finished, Error)
- Add detailed torrent information display (

Author: gerenciador323

README.md

@@ -190,14 +190,26 @@ O bot inclui um teclado personalizado que aparece na parte inferior do chat, for
 ### Comandos Gerais
 
 - `/start`: Inicia a interação com o bot e exibe mensagem de boas-vindas com o teclado personalizado
-- `/help` ou clique em ❓ **Ajuda**: Exibe a lista completa de comandos disponíveis e suas descrições
+- `/help` ou clique em **Ajuda**: Exibe a lista completa de comandos disponíveis e suas descrições
 
 ### Comandos do qBittorrent
 
 #### Gerenciamento de Torrents
 - `/qtorrents`: Lista todos os torrents ativos, pausados, finalizados e parados (requer autorização).
-  - Exibe nome, progresso, velocidade e status de cada torrent.
-  - Permite visualizar detalhes específicos de cada download.
+  - **Interface Aprimorada**: Formatação moderna com contadores e separadores visuais
+  - **Informações Detalhadas**: Exibe nome (limitado a 50 caracteres), progresso, tamanho, velocidade de download/upload
+  - **Categorização Inteligente**: 
+    - **Downloads Ativos** (até 5 exibidos)
+    - **Pausados** (até 3 exibidos)
+    - **Finalizados/Seeding** (até 3 exibidos)
+    - **Com Erro** (todos exibidos)
+  - **Botões Interativos**:
+    - **Atualizar Lista**: Atualiza a lista de torrents em tempo real
+    - **Pausar Todos**: Pausa todos os torrents ativos de uma vez
+    - **Retomar Todos**: Retoma todos os torrents pausados simultaneamente
+    - **Detalhes**: Exibe ajuda contextual sobre o gerenciador
+  - **Feedback Instantâneo**: Confirmação imediata de ações executadas
+  
 - **Links Magnet**: Envie qualquer link magnet válido para iniciar o download (requer autorização).
   - Formato: `magnet:?xt=urn:btih:...`
   - O bot confirmará o recebimento e iniciará o download automaticamente.

ROADMAP.md

@@ -83,10 +83,14 @@
   - [ ] Níveis de acesso (admin, usuário, convidado)
   - [ ] Restrição de comandos por nível
   - [ ] Logs de acesso e auditoria
-- [ ] Melhorias na interface de listagem de torrents
-  - [ ] Formatação aprimorada com contadores
-  - [ ] Limitação de caracteres em nomes longos
-  - [ ] Separadores visuais entre categorias
+- [x] ~~**Melhorias na interface de listagem de torrents**~~ (Concluído: 18/03/2026)
+  - [x] ~~Formatação aprimorada com contadores e separadores visuais~~
+  - [x] ~~Limitação de caracteres em nomes longos (50 caracteres)~~
+  - [x] ~~Categorização inteligente (Ativos, Pausados, Finalizados, Com Erro)~~
+  - [x] ~~Informações detalhadas (progresso, tamanho, velocidade)~~
+  - [x] ~~Botões inline para ações (Atualizar, Pausar Todos, Retomar Todos, Detalhes)~~
+  - [x] ~~Processamento de callbacks para botões interativos~~
+  - [x] ~~Feedback instantâneo de ações executadas~~
 
 ### v0.0.1.6-alpha (Previsto: Mai/2026)
 **Objetivo**: Sincronização e automação básica

qbittorrent_api.py

@@ -78,4 +78,91 @@ def get_transfer_info(sess, qb_url):
         return resp.json()
     except Exception as e:
         logger.error(f"Erro ao obter informações de transferência: {e}")
+        return None
+
+def pause_torrent(sess, qb_url, torrent_hash):
+    """Pausa um torrent específico.
+    
+    Args:
+        sess: Sessão autenticada do qBittorrent
+        qb_url: URL base da API do qBittorrent
+        torrent_hash: Hash do torrent a ser pausado
+        
+    Returns:
+        bool: True se pausado com sucesso, False caso contrário
+    """
+    try:
+        data = {"hashes": torrent_hash}
+        resp = sess.post(f"{qb_url}/api/v2/torrents/pause", data=data)
+        resp.raise_for_status()
+        logger.info(f"Torrent {torrent_hash} pausado com sucesso")
+        return True
+    except Exception as e:
+        logger.error(f"Erro ao pausar torrent {torrent_hash}: {e}")
+        return False
+
+def resume_torrent(sess, qb_url, torrent_hash):
+    """Retoma um torrent pausado.
+    
+    Args:
+        sess: Sessão autenticada do qBittorrent
+        qb_url: URL base da API do qBittorrent
+        torrent_hash: Hash do torrent a ser retomado
+        
+    Returns:
+        bool: True se retomado com sucesso, False caso contrário
+    """
+    try:
+        data = {"hashes": torrent_hash}
+        resp = sess.post(f"{qb_url}/api/v2/torrents/resume", data=data)
+        resp.raise_for_status()
+        logger.info(f"Torrent {torrent_hash} retomado com sucesso")
+        return True
+    except Exception as e:
+        logger.error(f"Erro ao retomar torrent {torrent_hash}: {e}")
+        return False
+
+def delete_torrent(sess, qb_url, torrent_hash, delete_files=False):
+    """Remove um torrent.
+    
+    Args:
+        sess: Sessão autenticada do qBittorrent
+        qb_url: URL base da API do qBittorrent
+        torrent_hash: Hash do torrent a ser removido
+        delete_files: Se True, remove também os arquivos baixados
+        
+    Returns:
+        bool: True se removido com sucesso, False caso contrário
+    """
+    try:
+        data = {
+            "hashes": torrent_hash,
+            "deleteFiles": "true" if delete_files else "false"
+        }
+        resp = sess.post(f"{qb_url}/api/v2/torrents/delete", data=data)
+        resp.raise_for_status()
+        logger.info(f"Torrent {torrent_hash} removido com sucesso (arquivos deletados: {delete_files})")
+        return True
+    except Exception as e:
+        logger.error(f"Erro ao remover torrent {torrent_hash}: {e}")
+        return False
+
+def get_torrent_info(sess, qb_url, torrent_hash):
+    """Obtém informações detalhadas de um torrent específico.
+    
+    Args:
+        sess: Sessão autenticada do qBittorrent
+        qb_url: URL base da API do qBittorrent
+        torrent_hash: Hash do torrent
+        
+    Returns:
+        dict: Informações do torrent ou None em caso de erro
+    """
+    try:
+        resp = sess.get(f"{qb_url}/api/v2/torrents/info", params={"hashes": torrent_hash})
+        resp.raise_for_status()
+        torrents = resp.json()
+        return torrents[0] if torrents else None
+    except Exception as e:
+        logger.error(f"Erro ao obter informações do torrent {torrent_hash}: {e}")
         return None