media-use
هر رسانه‌ای را برای ویدیوی HyperFrames پیدا، تولید و آماده‌سازی کنید.
این Skill برای مدیریت کامل رسانه در ویدیوهای HyperFrames است؛ از موسیقی، افکت صوتی، تصویر، آیکون و لوگو تا voiceover، آواتار، ویدیوی تولیدی، transcript و cutout. رسانه‌ها به‌صورت فایل محلی در assets/ ذخیره می‌شوند و همراه با رکورد ledger در رندر استفاده می‌شوند.
می‌توانید از سرویس‌های HeyGen یا ابزارهای رایگان و محلی استفاده کنید، رسانه‌های موجود را دوباره به‌کار ببرید و صداهای قرارگرفته روی timeline را mix کنید. برای فوتیج‌های تیره، تخت، کدر یا نیازمند استایل‌پردازی و پنهان‌سازی چهره نیز treatment مناسب پیشنهاد و اعمال می‌شود.
چه چیزی می‌گیرید
- پیدا کردن یا تولید موسیقی، sound effect، تصویر، آیکون، لوگو و voiceover
- استفاده از آواتار و ویدیوی تولیدی HeyGen یا ابزارهای محلی رایگان
- تبدیل گفتار به متن، حذف پس‌زمینه و آماده‌سازی رسانه در `assets/`
- اعمال grade، LUT، look، reveal و treatment برای فوتیج واقعی
- میکس ترک‌های صوتی با fade، gain، ducking، automation و افکت‌ها
برای چه کاری خوب است
- ساخت ویدیوهای HyperFrames که به رسانه‌های واقعی و آماده‌استفاده نیاز دارند
- پروژه‌هایی که باید بین HeyGen و ابزارهای محلی رایگان انتخاب کنند
- بهبود فوتیج‌های تیره، تخت، کدر یا دارای چهره و عناصر حساس
- تولید ویدیوهای آموزشی، تبلیغاتی، معرفی محصول و محتوای اجتماعی
برای چه کاری نیست
- پروژه‌هایی که فقط به انیمیشن HTML و بدون هیچ رسانه صوتی یا تصویری نیاز دارند
- زمانی که به تدوین کامل و غیرخطی ویدیو در نرم‌افزارهایی مانند Premiere یا DaVinci Resolve نیاز است
- استفاده از آواتار، voice یا موسیقی HeyGen بدون دسترسی به حساب یا اعتبار لازم
دربارهٔ این اسکیل
Plugin installs: Before setup or freshness commands, follow plugin execution rules when this skill is inside a HyperFrames plugin.
Media in HyperFrames
Media lands as a local file in the project's assets/ with a ledger record; renders never fetch. One verb finds or makes it:
npx hyperframes media-use resolve --type <type> --intent "<what you need>" --project <dir>It prints one line, resolved <id> → <path> (<type>, <metadata>). List reusable assets first with --candidates and judge the fit yourself; reuse, ingest (--from) and adopt are in references/resolve.md.
Two ways to get it
| Need | HeyGen (best quality) | Free, no account |
|---|---|---|
Music (bgm) | Catalog of 10k+ tracks | Local MusicGen (audio/references/bgm.md) |
Sound effects (sfx) | Openverse; 21 bundled offline | |
| Images, icons | Asset search, 75k+ | Local FLUX (mflux), if installed |
Logos (logo) | theSVG, GitHub avatar, favicon; never redrawn | |
Voiceover (voice) | HeyGen voices, voice cloning | npx hyperframes tts (Kokoro on device; Python 3.10+ with pip install kokoro-onnx soundfile) |
| A presenter speaking | Avatar video (--type video) | Local LTX for generic clips, if installed |
| Transcripts | npx hyperframes transcribe (Parakeet or whisper) | |
| Cutouts | heygen background-removal | npx hyperframes remove-background |
| Grades, LUTs, looks | npx hyperframes media-treatment |
Host apps. Inside an app that gives you its own media tools, use those first. When HEYGEN_API_BASE is set, the host pays for HeyGen: don't ask for the heygen CLI or a sign-in, and when a call is refused, relay the host's message as written and stop.
HeyGen. Install the heygen CLI and sign in with heygen auth login --oauth: the OAuth session carries a free allowance on subscription credits; an API key (--api-key) bills API credits. Check setup with npx hyperframes media-use resolve --doctor. When a request needs HeyGen (a presenter or avatar, a HeyGen voice, catalog music) and heygen is missing or signed out, tell the person how to get it: the install link, heygen auth login --oauth for the free allowance, or an API key for credits. Then offer the free path or wait. Beyond resolve, the same CLI makes text-to-video (heygen video-agent create), avatar videos with a recorded track (heygen video create), cloned voices (heygen voice clone create), dubbing (heygen lipsync), translated videos (heygen video-translate) and short clips from a long video (heygen ai-clipping): recipes in references/operations.md.
Free. Every tool in the free column needs no account; local models are opt-in installs (references/setup-providers.md). Without heygen, resolve for music, images and icons fails and says so; credit CC BY sounds (audio/references/sfx.md). --local-only skips every network provider.
Cost. Confirm before a paid call you chose to make (an avatar video counts); one the person asked for just runs. --provider <name> pins one generator when the person names it.
Looks on real footage
Feedback that footage is dark, flat or dull, should feel retro or printed, needs a face hidden, or needs a reveal is media intent: read references/media-treatments.md. Inspect the real <img>/<video>, pick one intent, start from npx hyperframes media-treatment --capabilities --json, then --capability <id>; never --all. Persist the final treatment with npx hyperframes media-treatment; no CSS or SVG stand-ins for supported effects, and no generated .cube just to encode exposure or warmth.
Offer once, never add silently
When you build or review a piece, scan once for concrete gaps (on-screen text with no voiceover, emoji standing in for icons, placeholder images, silent cuts, 10 s+ with no music, a colour cast) and offer the specific fixes in one ask. No signal, no suggestion; respect "leave it".
Where to look
| Task | Read |
|---|---|
| Resolve, reuse, adopt, ingest, flags | references/resolve.md |
Grading, LUTs, grade-compare | references/grading.md |
| Voiceover, music, sound effects, captions, transcription | references/audio.md |
| Cut, reframe or transform media; HeyGen recipes | references/operations.md |
| Treatments, realtime effects, overlays, reveals | references/media-treatments.md |
| Install, sign-in, providers, RAM ladders | references/setup-providers.md |
| Fades, gain, ducking, automation, effects, buses on placed tracks | references/mixing.md |
| Local commands: grade, cutout, loudness, beats | references/local.md |
| Remembered preferences | references/memory.md |