hyperframes-audio

Mix audio tracks in HyperFrames compositions with effects chains, automation envelopes, and voiceover carving.

13|17|Updated Jan 30, 2025
One-click install
npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill hyperframes-audio-codewithsally
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyperframes-audio
Source: https://github.com/CodeWithSally/CodeWithSally-Apex-English/tree/main/Sessions/ClaudeCode/Session007/.agents/skills/hyperframes-audio
Command: npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill hyperframes-audio-codewithsally

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @hyperframes/core, ffmpeg, and includes scripts (resource) and references (resource) components.

What problem does it solve? Audio tracks placed in a HyperFrames composition often fight each other — a music bed drowns out a voiceover, a voice sounds boomy or harsh, or levels drift across a take. This Skill mixes already-placed audio by writing effect chains, volume automation, and voiceover carve settings directly onto the composition's audio and video elements. ## Core Features & Use Cases - Effect Chains: Build serial data-fx-chain JSON on audio/video elements using filters, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, and bitcrush, with the same graph driving preview and render. - Voiceover Carve: Run scripts/carve.mjs to analyze voice tracks and automatically cut the bands they occupy out of the music bed, with dynamic ducking envelopes that follow the speech. - Automation Envelopes: Write data-automation lanes on track volume or automatable effect parameters using clip-local breakpoints. - Diagnosis & Presets: Measure files you cannot hear with ffmpeg-based recipes, then apply named jobs (Tame Boominess, Reduce Mud, Add Clarity) or presets like voice-clean. - Use Case: Given a composition with narration over background music, run the carve script to make the voice intelligible while the bed keeps its low end and top, then add a limiter as the final ceiling. ## Quick Start Run the carve script on my composition index.html so the music bed makes room for the narration track.

Frequently Asked Questions about hyperframes-audio

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

FAQPage Schema
How do I duck background music under a voiceover in HyperFrames?

Run node scripts/carve.mjs --comp index.html to apply a voiceover carve. It detects the bed and voice tracks, cuts the bands the voice occupies out of the bed, and writes a dynamic level envelope, keeping the music present while the voice stays intelligible.

How do I add audio effects like EQ or reverb to a HyperFrames track?

Write a data-fx-chain JSON attribute on the audio or video element listing effect nodes in signal order. Available effects include highpass, peaking, compressor, limiter, gate, saturate, delay, reverb, chorus, phaser, and bitcrush, with parameters in dB, Hz, and ms.

Which audio effect parameters can be automated in HyperFrames?

Only parameters backed by a Web Audio AudioParam can be automated, such as filter frequency and gain, delay time, and reverb wet/dry. The worklet effects compressor, limiter, gate, and bitcrush expose no automatable parameters; automate a gain stage before them instead.

Why does my automation lane do nothing on a compressor?

Compressor, limiter, gate, and bitcrush are AudioWorklet effects configured wholesale, so no AudioParam backs their knobs and lanes on them are silently inert. To change their behavior over time, automate a gain stage placed before the effect in the chain.

What are the limitations of the voiceover carve script?

The carve script requires ffmpeg on PATH and @hyperframes/core installed in the composition's project. It refuses to run when it cannot identify which track is the music bed, and it only processes tracks that actually overlap the bed on the timeline.

When should I not use this audio mixing skill?

Do not use it for sourcing or generating audio such as finding BGM, SFX, or creating voiceovers, which belongs to media-use, nor for clip timing and track layout, which belongs to hyperframes-core. It only mixes audio already placed in a composition.