BeatScope skill
BeatScope measures beats, accents and song structure and hands an agent exact timing so it can build visuals to the music
- 86 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Rendering runs Node.js, Playwright and FFmpeg on your machine
- An agent writes and runs code from the package that reads your files
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/beatscopeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Rendering runs Node.js, Playwright and FFmpeg on your machine
- An agent writes and runs code from the package that reads your files
This is third-party code. Review the repository files before installing.
What it does
BeatScope listens to an audio file and finds beats, sharp attacks, energy and tempo changes and repeated sections. The Beathi studio turns these measurements into a clip preview and a `.beatscope` timing package. Everything is computed locally and the audio is not uploaded. The package holds `rhythm-map.json`, MIDI and CSV views, a deterministic JavaScript runtime, a self-check and short instructions for an agent. The agent receives the song, your assets and a task, and builds the picture itself, as the package carries measurements and no finished visual style. The project ships a `beatscope-visualizer` skill that teaches the agent to query rhythm map summaries and assemble an edit plan. Without an agent, Beathi renders the whole clip to MP4 at 30 frames per second in 1:1, 16:9 or 9:16, at 720p or 1080p. Four templates are included: Voxel Interference, Prismatic Echo I and II, Pastel Bloom.
Who it is for. Video editors and developers who make music clips and visualizers and want to give a song rhythm to an agent.
Good fit when
- You need to turn a track into a clip with visual accents landing on the beats
- An agent should cut video from your footage following the song structure
- You need timing exported to MIDI or CSV for another program
- Music must not go to third-party services, so processing has to stay on your machine
Not a fit when
- The visuals are not tied to music, so rhythm measurements add nothing
- You need a full video editor with a timeline for manual cutting
- You need lyrics or note transcription: the project measures rhythm and energy and does not recognize words or notes
Example request
Take the .beatscope package and my footage and build a 30 second clip where cuts land on the song accentsLimitations
- WAV, FLAC, MP3, OGG and M4A are supported.
- The Prismatic Echo templates use a separate material pack, extracted next to the project or set in `BEATSCOPE_MATERIAL_ROOT`.
- Video in Python mode needs the render dependencies from the docs; the Windows build bundles them.
- The source audio, references and a visual template are not in the package: assets and rights to them stay with you.
- Version 0.16.0, a young project, so the package format may change.
How to disable. Delete the Beathi Studio folder or run `pip uninstall beatscope`; remove the skill from the agent skills folder.
FAQ
What does an agent get from BeatScope?
A `.beatscope` package with a JSON rhythm map, MIDI and CSV views and a runtime that returns the music state at any moment. The source audio and references are not included.
Is the music uploaded to a server?
No, analysis and rendering run locally.
How do I run the studio on Windows?
Download the Beathi Studio archive from the release, extract it whole and run `Beathi Studio.exe`: the analyser, Node.js, Playwright and FFmpeg are inside.
Which audio formats does BeatScope accept?
WAV, FLAC, MP3, OGG and M4A.
Which clip templates exist?
Four: Voxel Interference, Prismatic Echo I and II, Pastel Bloom. Prismatic Echo and Pastel Bloom accept your own images and video.
Discussion
No questions or reviews yet.
Related
SkillsBeatDesign MCP connects an agent to a local video editor, with clips, images and captions visible in the browser during editing.
A skill that makes a music video for your song: every frame is drawn by code and six steps with pauses lead from analysis to edit
A skill for Cursor, Claude Code and Codex: from a product name or URL it builds a 4K promo with music, voice-over and checks
A local video studio for your coding agent: describe a video in one sentence, the agent directs, your machine renders with no cloud
A skill that makes video in pure code: narrated explainers and website promos in 35 visual styles, in 16:9 and 9:16.
A CLI and MCP server: an agent makes video from a brief on your Seedance, Runway, Veo and Kling keys under a hard spend cap
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| BeatScope (this card) | no | 86 | |
| music-mv | no | 130 | a skill that leads a clip through six steps from track analysis to editing, while BeatScope hands an agent measured timing for any edit |
| HyperFrames | no | 83,841 | an agent renders clips from HTML compositions, and BeatScope adds the measured rhythm of a song |
README in short
The README walks through three steps: upload a track, pick a template and assets, render a clip or give the package to an agent. It then covers four templates, editing stage boundaries on the rhythm graph and the agent package contents, and ends with links to MCP and WebMCP docs.