Przejdź do treści
Biblioteka skilli
Marketing i treści · Konwersja i formaty

captions

/captions

Dodaje napisy do wideo: wypala je w obrazie albo eksportuje plik SRT lub VTT, z automatyczną transkrypcją i poprawkami.

Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dodaje napisy do wideo: wypala je w obrazie albo eksportuje plik SRT lub VTT, z automatyczną transkrypcją i poprawkami.

Oryginalny opis (EN)

Add subtitles/captions to a video — burn them into the picture, or export an .srt/.vtt file (for YouTube etc.). Use whenever the user wants captions, subtitles, on-screen text of what's being said, an SRT/VTT file, or accessibility text. Covers auto-transcription, editing for accuracy, styling, and the verbatim-vs-clean gotcha.

Jak działa

  1. CRITICAL: use --clean for captions
  2. Export a subtitle file (no burn-in)
  3. Burn captions into the video
  4. Gotchas
Sekcje z nagłówków SKILL.md, w oryginale · 75 linii, 540 słów
Podgląd SKILL.md
---
name: captions
description: Add subtitles/captions to a video — burn them into the picture, or export an .srt/.vtt file (for YouTube etc.). Use whenever the user wants captions, subtitles, on-screen text of what's being said, an SRT/VTT file, or accessibility text. Covers auto-transcription, editing for accuracy, styling, and the verbatim-vs-clean gotcha.
---

> **Full Production Studio note:** this skill drives the toolkit in [agamm/video-agent](https://github.com/agamm/video-agent). Clone that repo and run your agent inside it for the scripts/paths below to work; the guidance itself is usable anywhere.

# Captions & subtitles

Two outputs, one transcription engine (mlx-whisper, same as `transcribe`):
- **Sidecar file** (`.srt` / `.vtt`) — for YouTube/Vimeo upload, re-editing, or other tools.
- **Burned-in** — pixels baked into the video (social clips where the player won't show a
  subtitle track). Rendered via PIL → ffmpeg overlay (mise ffmpeg lacks `drawtext`).

## CRITICAL: use `--clean` for captions

This is the opposite of `filler-removal`. Whisper is **verbatim by default** here (keeps
um/uh) because filler-removal needs them. Subtitles do **not** — viewers don't want "um, uh"
on screen. Always pass `--clean` when transcribing for captions:

```bash
uv run video-agent transcribe video.mp4 --clean --srt -o subs.srt
```

## Export a subtitle file (no burn-in)

```bash
uv run video-agent transcribe video.mp4 --clean --srt -o subs.srt   # SubRip
uv run video-agent transcribe video.mp4 --clean --vtt -o subs.vtt   # WebVTT
```

Upload `subs.srt` alongside the video, or hand-edit it (fix names/typos, retime) and burn
that edited file — see below.

## Burn captions into the video

```bash
# Auto-transcribe and burn in one step (uses --clean transcription internally? NO — pass it)
uv run video-agent captions video.mp4 -o captioned.mp4 --clean

# Best workflow for accuracy: transcribe → hand-edit the .srt → burn the edited file
uv run video-agent transcribe video.mp4 --clean --srt -o subs.srt
#   ...fix typos, proper nouns, retime any off lines in subs.srt...
uv run video-agent captions video.mp4 --srt subs.srt -o captioned.mp4
```

`--srt` accepts both `.srt` and `.vtt`. When `--srt` is given, no transcription runs — it
just burns the file you pass, so this is also how you re-burn after editing.

### Styling

```bash
uv run video-agent captions video.mp4 -o out.mp4 --srt subs.srt \
    --size 48 --color yellow --position bottom --no-box
```

- `--size` px (default ~5% of frame height) · `--color` white|yellow|red|black
- `--position` bottom (default) | top | center
- `--no-box` removes the semi-transparent legibility box (keep it for busy backgrounds)
- Text auto-wraps to ~90% of frame width, centered.

## Gotchas

- **Caption count = encode passes? No — one pass.** Every segment becomes a full-frame RGBA
  PNG overlaid with an `enable='between(t,…)'` gate, all in a single ffmpeg encode. Fine for
  clips and typical talks. For a very long video (many hundreds of segments) the command
  line gets large; split the video, caption each part, then concat.
- **Timing comes from whisper segment boundaries**, which read fine but can be ~0.3s loose.
  For tight sync, edit the times in the `.srt` and re-burn with `--srt`.
- **Word-level "karaoke" captions** (one or two words popping per beat) aren't built in here.
  Approximate by transcribing `--words`, grouping into short segments, and writing your own
  `.srt` with tight start/end per group, then `captions --srt`. For *animated* per-word pops
  (eased, scaled), use the optional `remotion-graphics` skill's `KineticCaption` — fed the same
  `--words` timestamps. Either way the timing is **grepped from the `--words` transcript, never
  scrubbed.**
- **Burn on the final-resolution video.** If you're also reframing for social
  (`reframe` skill), reframe **first**, then caption — so font size and wrapping match the
  output frame, not the original.
Pliki w paczce (3)
  • LICENSE.txt 1 KB
  • SKILL.md 4 KB
  • UPSTREAM.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · alfaris/full-production-studio100MIT
jameslashmar/chroma-ae-mcp100AGPL-3.0
evanbaker315/attentionos100MIT
zuckenbert/video-from-code100MIT
zaddy99999/video-editing-skills100MIT
ZeroPointRepo/youtube-skills100MIT
ZeroPointRepo/youtube-skills100MIT
Rudywizz/rudywizz-motion96MIT
Liamrjohnston/ai-video-editor-v286MIT

Migawka bazy z 13.11.2026 · wersja paczki 9cc058ac25ad (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100popcaps
    Dodaje animowane napisy słowo po słowie do wideo przez CLI popcaps i eksportuje napisy SRT, VTT lub nakładkę.
  • 100video-captions
    Tworzy napisy SRT i WebVTT z pliku wideo lub audio i wypala je w MP4, także jako duże krótkie podpisy do pionowych klipów.
  • 100capcut-captions
    Transkrybuje mowę w pliku wideo lub audio i tworzy napisy w CapCut, w tym pliki SRT lub VTT, bez pełnego montażu.
  • 100youtube-transcription
    Transkrybuje filmy YouTube na tekst przez OpenAI Whisper i yt-dlp, w tym napisy SRT i VTT i wyciąganie mowy z adresów URL.
  • 100burn-subtitles
    Generuje napisy do wideo (whisper.cpp lub faster-whisper) i zapisuje plik SRT obok filmu albo wypala napisy w obrazie, z możliwością użycia gotowego SRT i wybranym backendem whisper.
  • 100captions-subtitles
    Tworzy, edytuje i tłumaczy napisy, transkrybuje mowę przez Whisper i wypala podświetlane napisy do Shorts i Reels.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.