PTENES
Skill de OpenPCBot · Gemini

Lo que un cineasta ve en tu video

Envía un enlace o un archivo y recibe el análisis técnico: movimiento de cámara bloque a bloque, esquema de iluminación, paleta en hex, ritmo de edición, música y sonido, gráficos, y un paso a paso para recrear eso. Sin transcribir una sola palabra del diálogo.

Portada del proyecto analisevideo
Qué es

Lectura del lenguaje audiovisual, no transcripción

La transcripción ya existe (inemaVOX/Whisper). Lo que faltaba era alguien que mirara el video y dijera cómo se hizo.

🎥 Cámara bloque a bloque

Cada fragmento con código de tiempo: plano, ángulo, movimiento (dolly, gimbal, whip-pan, dron, orbital), velocidad y lo que aporta a la escena.

🎨 Luz, color y montaje

Paleta en hex, esquema de iluminación, look y lente aparente; cortes por minuto, ritmo, transiciones, cortes al ritmo y uso de cámara lenta.

🗂️ Banco de datos con búsqueda

Cada análisis se convierte en JSON + informe y se agrega a un índice local. Después puedes search drone, search synthwave, stats.

Cómo funciona

Del enlace al informe en una sola llamada

Todo es local, excepto el análisis visual, que realiza Gemini.

enlace o archivo→ yt-dlp (≤480p)→ ffprobe: duración y formato→ Gemini: lectura de cineasta→ analise.json + analise.md→ index.jsonl (base de datos)

Por qué 480p

El color, la luz y el movimiento se aprecian bien en esta resolución y la carga es rápida. Si supera los 18 MB, el archivo se vuelve a codificar a 360p/12fps solo para el análisis.

Lo que no hace

No ejecuta Whisper, no devuelve subtítulos ni clona música. Para la voz está inemaVOX; para clonar una pista, está la skill musica.

Solo mediante comando

En el bot, se ejecuta solo en /analisevideo. El enlace suelto en Telegram sigue llevando a la transcripción, a propósito.

Requisitos previos

Lo que debe estar en la máquina

Sin servidor: solo shell + python3 + una clave de Gemini.

Binarios

Descarga, lectura de metadatos y consulta a la base de datos.

# Ubuntu/Debian
sudo apt install ffmpeg jq python3
pip install -U yt-dlp

Clave de Gemini

Leída en runtime de .env de OpenPCBot (o de wifi). Nunca se copia aquí.

# ~/projetos/openpcbotv2/.env
GOOGLE_API_KEY=...

Clon

El repo es la skill: OpenPCBot apunta aquí mediante un symlink.

git clone git@github.com:inematds/analisevideo.git \
  ~/projetos/analisevideo
Guía de uso · paso a paso

Analizar, leer y consultar

Comandos reales. S=~/projetos/analisevideo/analisevideo.sh

1

Analizar un enlace

Descarga, lee lo visual y archiva. La ruta del informe aparece en la última línea.

bash $S analisa "https://www.youtube.com/shorts/XXXX"  # descarga, analiza, indexa
2

Analizar un archivo local

Sirve para material que yt-dlp no puede descargar (sitio con sesión iniciada) o para un fragmento ya recortado.

bash $S analisa ~/videos/reel.mp4 reel-marca --keep-src  # guarda el fuente.mp4
3

Enfocar el análisis en una pregunta

--prompt agrega una solicitud específica, respondida en el campo pedido_extra.

bash $S analisa "<url>" --prompt "como eles seguram a atenção nos 3 primeiros segundos"
4

Volver a leer el informe

Markdown listo para pegar en un briefing, guion u orden de trabajo.

bash $S ver reel-marca      # informe
bash $S json reel-marca     # estructurado, para script
5

Consultar la base de datos

Aquí es donde se convierte en un archivo: puedes buscar por movimiento, look, género musical o etiqueta.

bash $S list 10               # últimos 10 análisis
bash $S search "drone"       # todo lo que tiene dron
bash $S stats                # movimientos y etiquetas más frecuentes
6

En Telegram, a través de OpenPCBot

La skill se activa como comando del bot; no se dispara sola desde un enlace.

/analisevideo <url|caminho>   # resumen + analise.md adjunto
/analisevideo search drone
/analisevideo stats
Ejemplos

Fragmentos de un informe real

Resultado del análisis de 5s de una infografía animada.

Fotografía

Paleta: #5DA9E9, #E85D3F, #46729B,
        #8C9BAE, #58B868, #FFFFFF
Luz: iluminação digital uniforme
Cor: equilibrada · contraste médio
Look: infográfico didático / flat 3D

Cámara

00:00–00:05 · geral · estático
  · plongée — quadro fixo com o
  diagrama animado por camadas

Base de datos

$ bash $S search tornado
teste-agnes [motion graphics explicativo]
  tags: infografico, motion graphics,
  tornado, meteorologia, didatico
Roadmap

Dónde está y adónde va

El núcleo funciona hoy; lo demás es un archivo que se construye sobre él.

Listo
Análisis + base de datosDescarga, lectura cinematográfica, informe markdown, índice con búsqueda, reintento en Gemini y comando en el bot.
Siguiente
Comparar videosPoner dos análisis lado a lado (ritmo, paleta, gancho) para decidir la referencia de un proyecto.
Después
De la base de datos a la producciónTransformar el campo reproduzir en una orden de trabajo directa para pixflow / Kling / Veo.