📘 README Projeto VirtunoRunner

Spread the love

📘 ReadMe

# 🎹 VirtunoRunner

O **VirtunoRunner** é um executor visual em **Python + NiceGUI**, capaz de pré-visualizar, descarregar e tocar diferentes tipos de ficheiros.  
Especial atenção é dada aos **ficheiros MIDI**, que são renderizados no servidor com **FluidSynth/Timidity** e convertidos em áudio (WAV/MP3) para reprodução imediata no browser.

---

## ✨ Funcionalidades

- ✅ **MP3/WAV/OGG**: reprodução nativa no browser.  
- ✅ **MIDI (Render & Play)**: renderização no servidor (FluidSynth/Timidity → WAV/MP3).  
- ✅ **Imagens, Vídeos, HTML**: abertos diretamente no painel de preview.  
- ✅ **Logs detalhados**: mostra os comandos e erros de render.  
- ✅ **UI NiceGUI**: interface limpa e responsiva (desktop e Android).  

---

## 🖼️ Arquitetura da Solução

![VirtunoRunner Architecture](banner.png)

---

## 🚀 Instalação

### Dependências do Sistema (Ubuntu/Debian)
```bash
sudo apt-get update
sudo apt-get install -y fluidsynth fluid-soundfont-gm timidity ffmpeg

Python

pip install nicegui

⚙️ Variáveis de Ambiente

VariávelDefaultDescrição
EXECUTOR_OUTPUT_DIR/home/fgoncalves/Binaries/chatgpt_outputsPasta onde a app lê/escreve ficheiros.
EXECUTOR_PORT2020Porta HTTP da aplicação NiceGUI.
EXECUTOR_SESSION_SECRETvirtuno-secretSegredo de sessão NiceGUI.
EXECUTOR_TOKENvaziaToken opcional para proteger downloads.
GM_SF2auto-detetaSoundFont .sf2 para FluidSynth.

🧭 Como Usar

  1. Coloca os teus ficheiros .mid, .mp3, .wav na pasta definida em EXECUTOR_OUTPUT_DIR.
  2. Arranca a aplicação: python3 VirtunoRunner.py
  3. Abre no browser: http://localhost:2020
  • Botão Pré-visualizar → abre no painel lateral.
  • Botão Tocar (MP3/WAV).
  • Botão Renderizar & Tocar (MIDI).

📜 Licença

MIT (ou GPL, conforme preferires).

🌍 Projeto Open Source

O VirtunoRunner é software open-source, disponível para todos.
Contribuições, melhorias e forks são bem-vindos. 🎶


---
GITHUB 
VirtunoRunner 

### 🖼️ Banner Panorâmico

👉 Por Francisco Gonçalves in 28 August 2025 (c)
Contactos