Local Video Generator

Interfaz visual para generar vídeos cortos (LinkedIn, Reels, YouTube Shorts) directamente en tu ordenador, sin editores de vídeo ni suscripciones de terceros.

---

⚠️ Aviso importante

Nada del software que usa esta herramienta es mío. Yo solo estoy compartiendo la interfaz visual que construí para uso personal, iterando con IA.

Las herramientas que utiliza este proyecto son proyectos independientes de terceros:

Herramienta	Qué hace	Enlace
Streamlit	Interfaz visual en el navegador	streamlit.io
FFmpeg	Encoding de vídeo	ffmpeg.org
Pillow	Dibuja los frames	python-pillow.org
edge-tts	Voces neuronales (Microsoft, gratis)	github.com/rany2/edge-tts
ElevenLabs	Voces premium (requiere API key propia)	elevenlabs.io

---

💻 Compatibilidad por sistema

El rendimiento varía mucho según tu máquina:

Sistema	Qué esperar
Mac con Apple Silicon (M1/M2/M3/M4/M5)	Experiencia completa. Encoding H.265 por hardware (VideoToolbox), render paralelo sin throttling, voces nativas con say
Mac Intel	Funciona, encoding H.264 por software (más lento)
Windows	Funciona con FFmpeg instalado. Sin say de macOS — usa edge-tts o ElevenLabs
Linux	Funciona con FFmpeg instalado. Sin say de macOS

Si tu ordenador es lento, los vídeos tardarán más en generarse. La calidad del resultado es la misma.

---

🛠️ Requisitos previos

1. Python 3.10 o superior

Descarga desde python.org o con Homebrew en Mac:

brew install python

2. FFmpeg

Mac:

brew install ffmpeg

Windows: Descarga desde ffmpeg.org y añádelo al PATH.

Linux (Ubuntu/Debian):

sudo apt install ffmpeg

---

🚀 Instalación

# 1. Clona el repositorio
git clone https://github.com/danchojrin/local-video-generator.git
cd local-video-generator

# 2. Crea un entorno virtual (recomendado)
python -m venv .venv

# Mac/Linux:
source .venv/bin/activate

# Windows:
.venv\Scripts\activate

# 3. Instala las dependencias
pip install -r requirements.txt

# 4. Arranca la app
streamlit run app.py

Se abrirá automáticamente en tu navegador en http://localhost:8501.

---

🎙️ Motores de voz disponibles

• macOS say — solo Mac, sin instalación, usa el Neural Engine del chip Apple
• Edge TTS (Microsoft Neural) — gratuito, sin API key, voces en español de España, México, Argentina, Colombia
• ElevenLabs — voces premium, requiere cuenta y API key propias en elevenlabs.io

---

📁 ¿Dónde se guardan los vídeos?

Los vídeos se descargan directamente desde el navegador al terminar la generación — tú eliges dónde guardarlos. Las configuraciones guardadas se almacenan en ~/.pv_videogen/ (tu carpeta de usuario, no en el repositorio).

---

❓ Problemas comunes

ffmpeg: command not found → FFmpeg no está instalado o no está en el PATH.

La voz say no funciona en Windows/Linux → Normal, es exclusiva de macOS. Usa Edge TTS.

El vídeo tarda mucho → Es normal en ordenadores sin Apple Silicon. El render en paralelo ayuda, pero depende de los cores disponibles.

pip install falla con elevenlabs → Prueba pip install elevenlabs --upgrade. Si no usas ElevenLabs, no es necesario instalarlo.

---

📄 Licencia

MIT — úsalo, modifícalo, compártelo.