Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yantavares/calabreso.txt
This project converts videos into ASCII art! It supports playback directly in the terminal or rendering as a `.mp4` file with ASCII frames
https://github.com/yantavares/calabreso.txt
ascii-art cpp mp4-converter
Last synced: 15 days ago
JSON representation
This project converts videos into ASCII art! It supports playback directly in the terminal or rendering as a `.mp4` file with ASCII frames
- Host: GitHub
- URL: https://github.com/yantavares/calabreso.txt
- Owner: yantavares
- License: mit
- Created: 2024-05-01T16:02:03.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-12-01T00:44:48.000Z (about 2 months ago)
- Last Synced: 2024-12-23T03:47:34.395Z (23 days ago)
- Topics: ascii-art, cpp, mp4-converter
- Language: C++
- Homepage:
- Size: 49.2 MB
- Stars: 108
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ℹ️ English Version: [README_EN](README_EN.md)
# calabreso.txt
**Executáveis (sem configuração para execução) estão disponíveis! Veja o [README](app/README.md) 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:
```bash
git clone https://github.com/yantavares/calabreso.txt.git
cd calabreso.txt
```
2. Se precisar, torne o arquivo `play.sh` executável:
```bash
chmod +x play.sh
```
3. Instale os pacotes necessários:
```bash
# Para Ubuntu
sudo apt-get install libopencv-dev
pip install -r requirements.txt
```
4. **(Opcional)** Adicione seu arquivo de vídeo na pasta `videos`, ou use o `SampleVideo.mp4` já fornecido.
5. **(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`:
```bash
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**:
```bash
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):
```bash
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. 😄