edit-davinci

Files (3)

• SKILL.md
• openai.yaml · agents/
• edit_tools.py · scripts/

SKILL.md (first lines)

# Edit DaVinci

Edicion basica con DaVinci Resolve controlado por el MCP `davinci-resolve`: conectar, preparar el proyecto, cortar, renderizar y revisar.

## Archivos De La Skill

Todo lo necesario esta dentro de esta carpeta; las rutas son relativas a ella.

| Archivo | Para que |
|---|---|
| [scripts/edit_tools.py](scripts/edit_tools.py) | Lo que la API de Resolve no da: propiedades del video, silencios, fotogramas, copia ligera y revision |
| [agents/openai.yaml](agents/openai.yaml) | Ficha de la skill para Codex |

Los subtitulos estan en la skill hermana `captions-davinci` (`..\captions-davinci\SKILL.md`).

[scripts/edit_tools.py](scripts/edit_tools.py) necesita Python 3 y ffmpeg/ffprobe en el PATH:

```powershell
python scripts\edit_tools.py probe   --video "<video>"
python scripts\edit_tools.py silence --video "<video>" --at 479.84
python scripts\edit_tools.py frames  --video "<video>" --outdir "<temp>" --at 481 510
python scripts\edit_tools.py encode  --video "<master>" --out "<copia para subir>"
python scripts\edit_tools.py review  --video "<render>" --outdir "<temp>" --every 2.5
```

## 1. Conectar Con Resolve

Comprobar siempre primero con `resolve_control get_version`. Si responde, saltar al paso 2.

Si devuelve `SCRIPTING_UNAVAILABLE`, el Resolve gratuito no acepta scripting externo y hay que pasar por el bridge interno. Recorrer en orden:

1. **Version.** Tiene que ser el gratuito 21.0.x (o Studio). En el gratuito 21.1+ el scripting Python es solo de Studio y el MCP no puede controlarlo: no proponer actualizar.
2. **Resolve abierto.** `resolve_control runtime_mode` dice si esta en marcha; `resolve_control launch` lo arranca. En el gratuito, `launch` abre la aplicacion pero devuelve error de scripting: es lo esperado.
3. **Proyecto abierto.** En el Gestor de proyectos no hay barra de menus. El usuario crea o abre un proyecto cualquiera.
4. **Bridge en marcha.** Lo lanza el usuario, una vez por sesion de Resolve (no por proyecto): `Area de trabajo > Secuencias de comandos > resolve_bridge` (en ingles, `Workspace > Scripts`). No muestra ninguna ventana y se queda "ocupado"; es normal. Volver a probar `get_version`.

Si en ese menu solo aparece `resolve_bridge_canary`, Resolve lista los scripts Lua y se salta los de Python porque no encuentra un Python 3. El de Microsoft Store no le vale: hace falta el de python.org, que se registra en `HKCU\Software\Python\PythonCore`.

```powershell
winget install --id Python.Python.3.10 -e --source winget --scope user
```

Es una descarga: pedir permiso antes. Despues el usuario cierra Resolve del todo, lo reabre y lanza el bridge.

Si los scripts no estan en `C:\ProgramData\Blackmagic Design\DaVinci Resolve\Fusion\Scripts\Utility`, instalarlos con `python scripts/install_resolve_bridge.py` desde la carpeta del MCP.

## 2. Preparar El Proyecto

Leer las propiedades del video con `edit_tools.py probe` y fijar los ajustes con `project_settings set_setting`, en este orden y antes de crear ningun timeline (despues la cadencia ya no se puede cambiar):

1. `timelineFrameRate` = fps del video fuente.
2. `timelineResolutionWidth` y `timelineResolutionHeight`: 1080 y 1920 para vertical, o los del video para horizontal.
3. Solo en vertical: `timelineInputResMismatchBehavior` = `scaleToCrop`, para que el horizontal llene el encuadre recortando los lados.

Importar el video con `media_storage import_to_pool` (rutas absolutas) y leer su id con `project_settings project_summary` (`include_clips: true`).

Confirmar con `project_manager snapshot` y guardar con `project_manager save`.

`timelinePlaybackFrameRate` no se puede cambiar desde la API. Solo afecta a la reproduccion dentro de Resolve, no al render; el usuario lo cambia en Ajustes del proyecto > Master Settings.

## 3. Elegir Y Afinar Los Cortes

Si el usuario pide clips de un video largo, leer su transcripcion entera y proponerlos antes de tocar Resolve. No crear nada hasta que elija.

- Para shorts: entre 30 y 180 segundos, nunca mas.
- Cada clip empieza y acaba en frase completa y se entiende sin el resto del video.
- Presentarlos en una tabla (titulo, inicio -> fin, duracion, por que funciona), recomendar por cual empezar y decir que tramos se descartan y por que.

Los tiempos de una transcripcion por palabras son contiguos (una palabra acaba donde empieza la siguiente), asi que no dicen donde esta el silencio. Medirlo en el audio:

```powershell
python scripts\edit_tools.py silence --video "<video>" --at 479.84
```

Usar el corte sugerido mas cercano para la entrada y para la salida; la salida ya viene en fotogramas del video. Si no hay silencio al final (el hablante enlaza frases), cortar en el punto mas bajo y avisar de que el final queda seco.

Para vertical, mirar antes el encuadre con `edit_tools.py frames` en dos o tres segundos del tramo: el recorte se queda con la franja central (el 31,6 % del ancho de un 16:9). Si el sujeto no esta centrado o hay rotulos que se cortan a medias, decirlo.

## 4. Montar El Timeline

`media_pool create_timeline_from_clips` con `clip_infos`:

```json
{
  "name": "Short 01 - Claude vs Codex",
  "clip_infos": [
    { "clip_id": "<id>", "start_frame": 28793, "end_frame": 33312, "record_frame": 0 }
  ],
  "if_exists": "fail"
}
```

`start_frame` y `end_frame` son fotogramas del video fuente; `record_frame` es la posicion en el timeline. Varios tramos seguidos: una entrada por tramo, con `record_frame` igual a la suma de las duraciones anteriores.

Leer el resultado con `project_manager snapshot` (`include: ["timeline", "gaps_overlaps"]`): duracion esperada y cero huecos.

## 5. Renderizar

1. `render set_format_and_codec` con `mp4` y `H264`.
2. `render set_settings` en llamadas pequenas. Una llamada con muchas claves falla entera sin decir cual sobra:
   - `SelectAllFrames`, `TargetDir`, `CustomName`
   - `FormatWidth`, `FormatHeight`, `ExportVideo`, `ExportAudio`
3. `render add_job`, `render start` con ese `job_id`, y `render get_job_status` hasta `CompletionPercentage` 100.

Limites conocidos por el bridge:

- `TargetDir` debe estar dentro de `allowed_output_roots` de `~/.config/davinci-resolve-mcp/bridge.json` (por defecto `~\Movies`; crearla si no existe). Renderizar ahi y mover el archivo a su carpeta como `_master.mp4`.
- `VideoQuality` no se puede fijar: sale a unos 56 Mbps (unos 500 MB por 75 s a 1080x1920 y 60 fps). Ese es el master. La copia para subir se saca con `edit_tools.py encode` (H.264 CRF 18, tope 14 Mbps) o, si lleva subtitulos, con la skill `captions-davinci`.
- Importar un `.srt` al panel multimedia funciona, pero `append_to_timeline` no lo coloca en la pista de subtitulos. Si el usuario lo quiere en el timeline, que lo arrastre desde el panel.

## 6. Revisar Con Fotogramas

Obligatorio antes de decirle al usuario que esta listo. Nunca entregar un render sin haberlo mirado.

```powershell
python scripts\edit_tools.py review --video "<render>" --outdir "<temp>" --every 2.5 --at 21.0 48.6
```

Imprime resolucion, fps, duracion, peso, nivel de audio y fotogramas negros o congelados, y deja `sheet.jpg` (un fotograma cada `--every` segundos), `first.jpg`, `last.jpg`, los segundos pedidos con `--at` y, por cada `--strip`, 16 fotogramas seguidos de la franja de subtitulos. Abrir las imagenes y comprobar:

From kecoma1/MQL5-SKILLS, MIT.

More from kecoma1/MQL5-SKILLS