vb-downloader 0.1.2

Aplicativo para download automático do programa 'A Voz do Brasil'

VB Downloader

Um aplicativo para download automático do programa "A Voz do Brasil" para emissoras de rádio.

Novidades na versão 0.1.2

• Adicionado suporte para URLs alternativas sem zero à esquerda no dia
• Maior robustez no processo de download com tentativas em quatro fontes diferentes
• Melhor compatibilidade com diferentes formatos de URL do programa

Sobre o Projeto

O VB Downloader foi desenvolvido para automatizar o processo de download diário do programa "A Voz do Brasil", transmitido de segunda a sexta-feira. Este aplicativo é utilizado por várias emissoras de rádio em todo o Brasil para facilitar a retransmissão do programa obrigatório.

Funcionalidades

• Download automático do programa "A Voz do Brasil" em dias úteis
• Tentativas em múltiplas fontes (quatro URLs diferentes) para garantir o sucesso do download
• Suporte a diferentes formatos de URL (com e sem zero à esquerda no dia)
• Interface gráfica simples e intuitiva
• Personalização da pasta de destino e nome do arquivo
• Monitoramento contínuo com possibilidade de interrupção
• Registro detalhado de operações (logs)

Requisitos

• Python 3.6 ou superior
• Bibliotecas: requests, tkinter

Instalação

1. Instalar o Python

Windows

1. Acesse o site oficial do Python: https://www.python.org/downloads/windows/
2. Baixe a versão mais recente do Python 3 (3.6 ou superior)
3. Execute o instalador e marque a opção "Add Python to PATH"
4. Clique em "Install Now"
5. Verifique a instalação abrindo o Prompt de Comando e digitando:

   python --version
   

macOS

1. Acesse o site oficial do Python: https://www.python.org/downloads/macos/
2. Baixe a versão mais recente do Python 3 (3.6 ou superior)
3. Execute o instalador e siga as instruções
4. Verifique a instalação abrindo o Terminal e digitando:

   python3 --version
   

Linux (Ubuntu/Debian)

# Atualize os repositórios
sudo apt update

# Instale o Python e o pip
sudo apt install python3 python3-pip

# Verifique a instalação
python3 --version

2. Instalar o VB Downloader

Método 1: Instalação via pip (Recomendado)

# Instale diretamente do PyPI
pip install vb-downloader
# Em alguns sistemas pode ser necessário usar pip3 em vez de pip

Método 2: Instalação a partir do código-fonte

# Clone o repositório ou baixe os arquivos
git clone https://github.com/seu-usuario/vb-downloader.git
# Ou baixe o ZIP do projeto e extraia

# Entre na pasta do projeto
cd vb-downloader

# Instale o pacote em modo de desenvolvimento
pip install -e .
# Em alguns sistemas pode ser necessário usar pip3 em vez de pip

Como Usar

Executando o Programa

Após instalar o pacote via pip, você pode executar o programa diretamente do terminal:

# Execute o comando
vb-downloader

Se você instalou a partir do código-fonte, pode executar:

Windows

# Navegue até a pasta do projeto
cd caminho\para\vb-downloader

# Execute o programa
python -m vb_downloader.gui

macOS/Linux

# Navegue até a pasta do projeto
cd caminho/para/vb-downloader

# Execute o programa
python3 -m vb_downloader.gui

Solução de Problemas

Comando 'vb-downloader' não reconhecido

Se você receber um erro como "'vb-downloader' não é reconhecido como um comando interno ou externo", isso significa que o diretório de scripts do Python não está no PATH do sistema. Você pode resolver isso de duas maneiras:

1. Adicionar o diretório de scripts ao PATH:

   No Windows:

   • Localize o diretório de scripts do Python (geralmente C:\Users\<seu-usuario>\AppData\Local\Programs\Python\Python3x\Scripts ou C:\Python3x\Scripts)
   • Adicione este diretório ao PATH do sistema:
     • Abra o Painel de Controle > Sistema > Configurações avançadas do sistema
     • Clique em "Variáveis de Ambiente"
     • Edite a variável "Path" e adicione o caminho para o diretório de scripts
     • Reinicie o prompt de comando

   No Linux/macOS:

   • Adicione ao seu arquivo .bashrc ou .zshrc:

     export PATH="$PATH:$HOME/.local/bin"
     

   • Reinicie o terminal ou execute source ~/.bashrc

2. Executar usando o módulo Python:

   python -m vb_downloader.gui
   

Erro relacionado ao tkinter

Se você receber um erro relacionado ao tkinter, isso significa que a biblioteca gráfica não está instalada:

No Windows:

• Reinstale o Python e certifique-se de marcar a opção "tcl/tk and IDLE" durante a instalação

No Linux:

sudo apt-get install python3-tk  # Para Ubuntu/Debian
sudo dnf install python3-tkinter  # Para Fedora
sudo pacman -S tk                # Para Arch Linux

No macOS:

brew install python-tk

Utilizando o Aplicativo

1. Após iniciar o aplicativo, você verá a interface gráfica do VB Downloader
2. Clique no botão de pasta (📁) para selecionar a pasta de destino para os arquivos baixados
3. No campo "Nome do Arquivo", defina o nome desejado para o arquivo de áudio (opcional)
4. Clique em "▶️ Iniciar" para começar o monitoramento
5. O programa irá:
   • Verificar se é dia útil (segunda a sexta-feira)
   • Aguardar até às 20:20 para iniciar o download
   • Tentar baixar o programa de quatro fontes diferentes (com e sem zero à esquerda no dia)
   • Continuar tentando até às 20:58, caso necessário
   • Aguardar até o próximo dia útil após o download ou após o tempo limite
6. Para interromper o monitoramento, clique em "⏹️ Parar"

Uso em Emissoras de Rádio

Este projeto pode ser utilizado por diversas emissoras de rádio em todo o Brasil para automatizar o download e a retransmissão do programa "A Voz do Brasil", facilitando o cumprimento da obrigatoriedade de transmissão.

Desenvolvedor

• Erik Rocha - [e-mail]

Contribuições

Contribuições são bem-vindas! Se você encontrar bugs ou tiver sugestões de melhorias, por favor abra uma issue ou envie um pull request.