ℹ️ English Version: README_EN

calabreso.txt

Executáveis (sem configuração para execução) estão disponíveis! Veja o README ou a aba de Releases do repositório para mais informações.

Obrigado pelo suporte 🌠:

---

Esse é um projeto que transforma um vídeo em arte ASCII, convertendo cada quadro em texto usando qualquer fonte que você quiser. Ele oferece dois modos de saída:

1. Reproduz o vídeo em formato de texto diretamente no terminal.
2. Salva os quadros em ASCII como um arquivo .mp4 renderizado na pasta output.

Exemplo (leva alguns segundos para carregar):

---

Requisitos

• make (GNU)
• OpenCV2 (pode instalar com libopencv-dev no Ubuntu ou opencv no Fedora e Arch)
• Compilador g++ (para o motor em C++)
• Python3 (para o motor em Python)

---

Configuração (sistemas UNIX)

1. Clone o repositório:

  git clone https://github.com/yantavares/ascii.mp4.git
  cd ascii.mp4

1. Se precisar, torne o arquivo play.sh executável:

  chmod +x play.sh

1. Instale os pacotes necessários:

   # Para Ubuntu
   sudo apt-get install libopencv-dev
   # Para Arch
   sudo pacman -S opencv
   # Para Fedora/RH
   sudo dnf install opencv-devel

   pip install -r requirements.txt

1. (Opcional) Adicione seu arquivo de vídeo na pasta videos, ou use o SampleVideo.mp4 já fornecido.

2. (Opcional) Coloque sua fonte preferida (.ttf) na pasta fonts, ou use a fonte padrão ComicMono.ttf.

---

Como rodar o projeto

Para rodar o projeto, use o comando make:

   make

Você vai escolher entre dois modos de execução:

1. Reproduzir no terminal: Mostra o vídeo em ASCII direto no seu terminal.
2. Salvar como MP4: Gera um .mp4 renderizado na pasta output.

---

Passos após rodar o make:

1. Selecionar a fonte:
   • A padrão é Comic Mono.
2. Escolher o tamanho da fonte:
   • Deve ser compatível com o tamanho da fonte do terminal.
   • Escolha entre 2 e 20.
   • O padrão é 11.
3. Informar o nome do vídeo:
   • Escolha um vídeo da pasta videos.
   • O padrão é SampleVideo.mp4.
4. Selecionar o modo:
   • Escolha uma das opções:
     • 1: Reproduzir no terminal.
     • 2: Salvar como .mp4 na pasta output.

Se você não responder algum dos prompts, os valores padrão serão usados.

---

Comandos

• Para rodar no terminal ou gerar mp4 ASCII:

   make

Aviso: O vídeo será redimensionado automaticamente para caber na janela do terminal, não use uma janela muito pequena.

• Para reproduzir o vídeo no terminal após rodar make (sem qualquer processamento adicional):

   make play

---

Saídas

1. Se você escolher o Modo 1, o vídeo será exibido diretamente no terminal.
2. Se você escolher o Modo 2, o vídeo renderizado em ASCII será salvo como .mp4 na pasta output.

Além disso, todos os quadros individuais do vídeo em ASCII serão salvos como arquivos .txt na pasta output.

---

Licença

Esse projeto está sob a licença MIT.

---

Contribuições

Contribuições são super bem-vindas! Abra uma issue ou envie um pull request para qualquer melhoria ou sugestão. 😄