name: video-caption-generator description: > Transkribeeri lühivideod Google Drive’i kaustast, eemalda sisu järgi duplikaadid ja loo sotsiaalmeedia kirjeldused + YouTube’i/Facebooki pealkirjad. Kasuta, kui uued videoklipid pannakse Drive’i kausta ja vajad iga unikaalse klipi jaoks transkripti, kirjeldust ja pealkirja. Trigger phrases: "process videos in drive", "transcribe new clips", "caption these videos", "generate titles for these clips".

Video kirjelduste generaator

Töötleb Google Drive’i kaustast uusi MP4-faile: transkribeerib, eemaldab duplikaadid, loob sotsiaalmeedia kirjeldused + YouTube’i/Facebooki pealkirjad.

Drive’i kausta seadistus

Seadista Google Drive’i kaustade ID-d enne esimest kasutamist:

Kaust	Eesmärk
Main / To Schedule	Siia pannakse uued klipid töötlemiseks
Scheduled	Juba postitatud/ajakavasse pandud klipid (liigutatakse pärast avaldamist)
A/B	Pealkirja variandid hilisemaks postitamiseks

Sea kaustade ID-d failis folder-map.json või anna need otse lipuga --folder-id.

Kiirkäivitus

python3 skills/video-caption-generator/scripts/process_videos.py \
  --folder-id YOUR_FOLDER_ID

Töödeldud video ID-d logitakse faili processed_ids.json, nii et juba nähtud videod jäetakse järgmistel jooksudel vahele.

A/B variantide käsitlemine

Videod, millel on identne transkript, aga erinev failinimi (nt 0411.mp4, 0411(1).mp4), on A/B pealkirja variandid — sama heli, erinev ekraanil pealkiri. Skript töötleb KÕIKI variante (duplikaate ei jäeta vahele) ja märgib need väljundis A/B variantideks.

Väljundi vorming

Iga unikaalse uue klipi kohta väljasta:

*<filename>*
📝 *Transcript:* <raw spoken words>
🎬 *Caption:* <social-friendly 2-4 sentence caption>
📺 *YT/FB Title:* <punchy title under 60 chars>

Kirjelduse + pealkirja stiilijuhend

Caption: Esimene isik, vestluslik, ilma hashtagideta, 2–4 lauset. Kõigepealt haakija, siis insight.
Title: Uudishimu tekitav, alla 60 tähemärgi, mitte „How I…“, kui see pole välja teenitud. Alusta pingest või numbrist.

Sõltuvused

whisper (kohalik paigaldus, mudel: turbo)
Google Drive CLI või SDK failide loetlemiseks/allalaadimiseks
Anthropic API võti (sea keskkonnamuutujaga ANTHROPIC_API_KEY)

Seadistus

Sea ANTHROPIC_API_KEY oma keskkonda
Uuenda GWS_GATEWAY failis scripts/process_videos.py, et see osutaks sinu Google Drive CLI-le
Uuenda WHISPER_BIN, kui Whisper on paigaldatud teise teele

Uute kaustade lisamine

Anna --folder-id <ID> erinevate kaustade jaoks. Iga kaust kasutab sama jagatud processed_ids.json logi (Drive’i ID-d on globaalselt unikaalsed, nii et kokkupõrkeid ei teki).