Subir vídeos para la nube

Subir vídeos a la nube

La video-animado entrega los MP4 en el proyecto. Esta skill coloca los archivos en una carpeta de nube con nombres que el equipo reconoce. Esos nombres se convierten en la clave para analizar después el resultado de cada creativo.

Patrón

<carpeta de destino, confirmada por el usuario>/
  <NOMBRE DE LA CAMPAÑA>/
    30S/                                     una subcarpeta por duración
      vvs_bala_coroa/                        una carpeta por vídeo
        vvs_vertical_bala_coroa.mp4          9:16 · 1080×1920
        vvs_wide_bala_coroa.mp4              16:9 · 1920×1080
        vvs_square_bala_coroa.mp4            1:1  · 1080×1080
        como_foi_feito.md                    proceso de creación del vídeo
    15S/
      vvs_bala_coroa/ …

• Nombre del archivo: <prefijo>_<formato>_<palabras>.mp4, todo en minúsculas. El prefijo es vvs por defecto y cambia con "prefijo" en el manifiesto.
• Formato: el vertical se convierte en vertical, el cuadrado en square y el horizontal en wide. El formato que no existe se omite; no inventar.
• Palabras: de 1 a 4, tomadas del título del vídeo, en minúsculas y sin tildes. Los artículos, preposiciones, "y" y "que" se omiten (el script los elimina automáticamente).
  • "La bala en la corona" se convierte en vvs_vertical_bala_coroa.mp4.
  • "Tres niños ante el poder" se convierte en vvs_wide_tres_ninos_ante_poder.mp4.
  • Si quedan más de 4, elegir en "palabras" en el manifiesto; el script lo rechaza hasta que se corrija.
• La carpeta del vídeo es <prefijo>_<palabras>. La duración solo va en la subcarpeta (30S/, 15S/) y en el registro. Un corte de 14,0 s va en 15S/.
• El mismo título en dos duraciones genera el mismo nombre de archivo en carpetas diferentes. El script lo advierte. En el administrador de anuncios, poner la duración en el nombre del anuncio.
• como_foi_feito.md en cada carpeta de vídeo, para que cualquier persona pueda analizar el proceso de creación. El script arma el documento a partir del proyecto de origen (atributos.projeto):
  • ficha técnica;
  • dirección, voz y pista musical;
  • concepto y guion, tomados del roteiro.json;
  • el ANALISE.md y el RELATORIO.md del proyecto: brief, conceptos, biblia y notas de la crítica.

Paso a paso

1. Carpeta de destino: quien lo pide siempre confirma. Nunca adivinar. Si no lo dicen, preguntar.
2. Encontrar la ruta local de la carpeta sincronizada. En macOS, Google Drive para escritorio está en ~/Library/CloudStorage/GoogleDrive-<su correo>/ (Mi unidad/, Unidades compartidas/). Si llega un enlace de Drive y hay conector de Drive, se puede subir a través de la cadena de carpetas padre (parentId) hasta el nombre que existe en el sync. Copiar a la carpeta sincronizada es la subida; no enviar MP4 grande por la API.
3. Montar el manifiesto (manifesto.json, modelo abajo): cada vídeo con título, duración nominal y la ruta de los archivos por formato, más los atributos para análisis (dirección creativa, proceso, voz, pista musical, proyecto de origen).
4. Mostrar la tabla de nombres y el destino antes de copiar, a menos que ya hayan dicho que suba directamente. Suele ser una carpeta compartida.
5. Ejecutar python3 ~/.claude/skills/subir-videos/subir.py manifesto.json.
   • Antes, ejecutar con --seco: solo valida y muestra los nombres.
   • Si los archivos ya están en la nube, usar --so-registro: graba solo el registro.
   • El script verifica dimensiones y duración, rechaza nombres fuera del patrón o títulos repetidos, crea las carpetas, copia y escribe el como_foi_feito.md de cada vídeo y agrega líneas al registro general ~/videos/VVS_REGISTRO.csv.
6. Verificar en la nube después de unos minutos, porque el sync sube en segundo plano y los archivos grandes tardan.
7. Entregar el enlace de la carpeta y la tabla de nombres, y registrar en el ANALISE.md del proyecto dónde fue a parar cada vídeo.

Manifiesto (modelo)

{
  "destino_local": "~/Library/CloudStorage/GoogleDrive-<su correo>/Unidades compartidas/<unidad>/<carpeta>",
  "campanha": "NOMBRE DE LA CAMPAÑA",
  "prefixo": "vvs",
  "drive_link": "https://drive.google.com/drive/folders/<id de la carpeta destino>",
  "videos": [
    {"titulo": "La bala en la corona", "duracao": "30S",
     "arquivos": {"vertical": "…/out/30s_9x16.mp4", "wide": "…/out/30s_16x9.mp4", "square": "…/out/30s_1x1.mp4"},
     "atributos": {"direcao": "animación 2D con personaje", "processo": "pedido-de-video + video-animado",
                   "voz": "Gemini TTS", "trilha": "Lyria, ~120 bpm", "projeto": "~/videos/<slug>"}}
  ]
}

Por qué existe el registro

El nombre <prefijo>_<formato>_<palabras> es la clave para cruzar con el resultado (con la duración en el nombre del anuncio). El equipo sube el creativo en el administrador de anuncios con ese nombre, y aparece en el nombre del anuncio en los datos de medios. El VVS_REGISTRO.csv guarda los atributos de cada vídeo (dirección, proceso, voz, pista musical, duración real), para comparar después qué funciona y qué no. No guardar datos personales en él.

No hacer

• No subir a una carpeta que no haya sido confirmada, ni borrar o renombrar archivos de otras personas en la carpeta.
• No cambiar el patrón de nombres por cuenta propia: el cambio de patrón es decisión de quien lo pide.
• Los MP4 no van al repositorio git.