acestep-simplemv

What This Skill Does

acestep-simplemv is a specialized OpenClaw skill designed to automate the creation of high-quality music videos using Remotion. It bridges the gap between raw audio files and visually engaging content by synchronizing audio waveforms with LRC or JSON-formatted lyrics. The skill handles the heavy lifting of video rendering, including timestamp synchronization, dynamic lyric display, and configurable output codecs, making it an essential tool for content creators and musicians.

Installation

To get started, first ensure your environment is configured for development. Navigate to the skill directory within your OpenClaw installation: {project_root}/.codex/skills/acestep-simplemv/. Run npm install within the scripts/ folder to install all necessary dependencies. You must also ensure that ffprobe is installed on your system, as it is required to calculate audio duration accurately. If ffprobe is missing, you can install the complete ffmpeg package via your system's package manager (e.g., brew install ffmpeg on macOS or apt-get install ffmpeg on Linux). Once installed, verify availability by running ffprobe -version in your terminal.

Use Cases

acestep-simplemv is ideal for generating lyric videos for YouTube, social media teasers for new music releases, and automated visualizers for podcasts or audiobooks. It is particularly effective for users who possess raw audio tracks and need to quickly generate professional-looking, synchronized visual assets without manual video editing software. It eliminates the need for complex keyframing in applications like Premiere or After Effects, allowing you to generate content directly from structured data files.

Example Prompts

1. "Create a music video for my new song using the file at /data/tracks/summer_vibe.mp3 and the lyric file at /data/lyrics/summer_vibe.lrc. Add a title card that says 'Summer Vibe' and render it at 1080p."
2. "I need to generate an MP4 visualization for this podcast episode: /home/user/podcasts/ep1.mp3. I have the captions in JSON format at /home/user/podcasts/captions.json. Can you make sure the subtitles appear synced with the audio?"
3. "Render a music video from this audio track. Use 'Midnight Echoes' as the title and set the output codec to h265 for better compression."

Tips & Limitations

For optimal results, ensure your LRC files are precisely timestamped. If the lyrics appear off-beat, use the --offset flag to nudge timing by milliseconds. Note that the rendering process is browser-dependent; the skill requires a Chromium-based browser. If your environment is restricted (e.g., firewalls blocking Google’s servers for downloading chrome-headless-shell), manually provide a path to a local browser installation using the BROWSER_EXECUTABLE environment variable. The default rendering speed depends heavily on your CPU and the complexity of the waveform visualization; keep video length reasonable for faster turnaround.