🎥 Media Downloader

Projeto desenvolvido em Python com foco em aprendizado, automação, manipulação de arquivos, uso de bibliotecas externas e boas práticas de desenvolvimento.

📌 Versão Atual

Versão: V2.1

Novidades da V2.1

• Escolha da qualidade do vídeo
• Escolha da qualidade do MP3
• Suporte a áudio em FLAC
• Melhor organização das opções de download
• Evolução do menu interativo no terminal

---

📖 Sobre o Projeto

O Media Downloader é uma aplicação em Python que utiliza a biblioteca yt-dlp para baixar mídias a partir de uma URL informada pelo usuário.

O projeto está sendo desenvolvido de forma incremental, com o objetivo de praticar Python, lógica de programação, manipulação de arquivos, tratamento de erros, integração com FFmpeg e versionamento com Git/GitHub.

---

🚀 Funcionalidades

Vídeo MP4

• Download de vídeo em MP4
• Escolha de qualidade:
  • Melhor qualidade
  • 1080p
  • 720p
  • 480p
• Mesclagem automática de vídeo e áudio com FFmpeg
• Geração de arquivo MP4 único

Áudio MP3

• Download apenas do áudio
• Conversão automática para MP3
• Escolha de qualidade:
  • 128 kbps
  • 192 kbps
  • 320 kbps

Áudio FLAC

• Download apenas do áudio
• Conversão automática para FLAC
• Formato sem perda de qualidade adicional na conversão

Gerais

• Menu interativo no terminal
• Validação de opções do usuário
• Exibição do progresso do download
• Criação automática da pasta downloads
• Tratamento básico de erros
• Bloqueio de download de playlists
• Organização automática dos arquivos baixados

---

🛠️ Tecnologias Utilizadas

---

📂 Estrutura do Projeto

media-downloader/
│
├── main.py
├── downloads/
├── README.md
├── requirements.txt
└── .gitignore

---

⚙️ Instalação

Clone o repositório:

git clone https://github.com/Lucksander/media-downloader.git

Entre na pasta do projeto:

cd media-downloader

Crie um ambiente virtual:

python -m venv .venv

Ative o ambiente virtual:

Windows

.venv\Scripts\activate

Linux

source .venv/bin/activate

Instale as dependências:

pip install -r requirements.txt

---

🔧 Dependências

requirements.txt

yt-dlp

FFmpeg

O FFmpeg é necessário para:

• Mesclar vídeo e áudio em MP4
• Converter áudio para MP3
• Converter áudio para FLAC

Verifique a instalação com:

ffmpeg -version

---

▶️ Como Executar

Execute o programa:

python main.py

Menu disponível:

======= Python Media Downloader =======

1. Baixar Vídeo MP4
2. Baixar Áudio MP3
3. Baixar Áudio FLAC
4. Sair

Após escolher uma opção, informe a URL da mídia desejada.

Os arquivos serão salvos automaticamente na pasta:

downloads/

---

📈 Histórico de Versões

V1.0

• Download básico utilizando URL
• Primeira implementação com yt-dlp

V1.1

• Organização dos downloads em pasta própria
• Melhor estrutura do projeto

V1.2

• Criação automática da pasta downloads
• Barra de progresso
• Tratamento de exceções

V1.3

• Integração com FFmpeg
• Mesclagem automática de vídeo e áudio
• Geração de arquivo MP4 único

V2.0

• Escolha entre vídeo MP4 e áudio MP3
• Conversão automática para MP3
• Menu interativo
• Validação de entrada do usuário

V2.1

• Escolha da qualidade do vídeo
• Escolha da qualidade do MP3
• Suporte ao formato FLAC
• Melhorias no menu interativo
• Melhor organização das configurações de download

---

📌 Próximas Melhorias

V2.2

• Escolha da pasta de destino

V2.3

• Histórico de downloads

V3.0

• Interface gráfica com Tkinter

V4.0

• Refatoração em múltiplos arquivos

V5.0

• API utilizando FastAPI

---

🎯 Objetivos de Aprendizado

Este projeto está sendo utilizado para praticar:

• Python
• Funções
• Estruturas condicionais
• Loops while
• Tratamento de exceções
• Manipulação de arquivos e diretórios
• Bibliotecas externas
• Automação
• Conversão de mídia com FFmpeg
• Versionamento com Git
• GitHub
• Documentação técnica
• Boas práticas de programação

---

⚠️ Aviso

Este projeto possui finalidade exclusivamente educacional.

O uso deve respeitar os Termos de Serviço das plataformas utilizadas e a legislação de direitos autorais aplicável.

---

👨‍💻 Autor

Lucas Santos

🐙 GitHub: https://github.com/Lucksander

💼 LinkedIn: https://www.linkedin.com/in/lucas-j-santos-dev/