hyperframes-media

Generates TTS narration, word-level transcripts, and transparent background-removed video for HyperFrames compositions.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/gmolike/Claude-Template --skill hyperframes-media-gmolike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-media
Source: https://github.com/gmolike/Claude-Template/tree/main/.agents/skills/hyperframes-media
Command: npx skills add https://github.com/gmolike/Claude-Template --skill hyperframes-media-gmolike

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kokoro-onnx, soundfile.

What problem does it solve? Producing voiceover audio, caption timestamps, and transparent subject overlays for video compositions normally requires separate paid services and manual editing. This Skill provides three local CLI commands that generate these assets directly, with models downloaded and cached on first run. ## Core Features & Use Cases - Text-to-Speech: Generate narration locally with Kokoro-82M across 54 voices and 9 languages, with speed control and script-file input for long content. - Transcription: Produce word-level timestamped transcript.json from audio, video, SRT, VTT, or OpenAI API responses using Whisper models from tiny to large-v3. - Background Removal: Cut subjects out of video or images into VP9-alpha WebM, ProRes 4444 MOV, or PNG, with an optional inverse-alpha plate layer for text-behind-subject effects. - Use Case: Write a narration script, run npx hyperframes tts script.txt --voice af_heart --output narration.wav, then npx hyperframes transcribe narration.wav to get caption-ready word timestamps without any manual timing. ## Quick Start Generate a voiceover from my script file and transcribe it back into a word-level transcript.json for captions in my composition.

Frequently Asked Questions about hyperframes-media

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate text-to-speech narration locally without an API key?

Run npx hyperframes tts with your text or a script file, a voice ID like af_heart, and an output path. It uses the local Kokoro-82M model, downloads it on first run, and requires Python with kokoro-onnx and soundfile installed.

How do I get word-level timestamps from audio for captions?

Run npx hyperframes transcribe on your audio or video file to produce a transcript.json with per-word start and end times. The default model is small; use medium or large-v3 for noisy audio or music.

Which Whisper model should I use for non-English transcription?

Never use .en models for non-English audio because they translate instead of transcribe. Use --model small --language <code> for known languages, or plain --model small to let Whisper auto-detect the language.

How do I remove a video background into a transparent overlay?

Run npx hyperframes remove-background subject.mp4 -o transparent.webm to get a VP9-alpha WebM using u2net_human_seg. Use .mov for ProRes 4444 editing workflows or .png for single-image cutouts.

When should I use --background-output versus an inpainter?

Use --background-output when you want to place text or graphics between the subject cutout and its surroundings, since it emits a hole-cut plate. If you need the room shown alone without the person, you need an inpainting tool like LaMa or ProPainter instead.

Why is my cutout video opacity animation not working in the composition?

The framework forces opacity:1 on any element with data-start/data-duration attributes, overriding direct animation. Wrap the cutout video in a plain div without data attributes and animate the wrapper's opacity with GSAP instead.