AgentFX is open source under Apache 2.0.

agentfxhq/agentfx

Audio visualizer and beat-synced motion

The music is analysed when the script compiles: level, onsets, frequency bands and the beat grid. Visualizers and any property can follow it, and cuts land on bars and beats.

script.reel
music src=assets/track.mp3

scene viz dur=10s bg=#0B0D14
  visualizer #ring type=radial mirror count=64 radius=160 colors=[#5EEAD4, #A78BFA]
  ellipse #core w=250 h=250 x=50% y=44% anchor=center glow=audio(band=0, gain=40)
  pulse #core on=beat amount=0.12 decay=250ms
  text #drop "DROP" size=96 weight=900 x=50% y=75% anchor=center opacity=0
  at bar:5
    set #drop opacity=1
    shake #ring

Ask your agent

"Make a 15 second lyric-free visualizer for our track: radial spectrum, logo pulsing on the kick, colour change at the chorus on bar 9."

The agent writes the script, lints it, checks a contact sheet and renders every format. You give notes in plain words.

Parameters

  • visualizer type: bars, radial, waveform; count, gap, mirror, smooth
  • audio(level|band|onset): drive any number from the music
  • pulse on=beat: a hit on every beat
  • at beat:N / at bar:N: events on the beat grid

Related effects

FAQ

Which audio formats work?

MP3, WAV and other common formats. The analysis runs once at compile time and is baked into the film.

Can text and cuts follow the beat?

Yes. Beat and bar anchors work for every event, not only for visualizers.

Put an effects engine in your agent's hands.

AgentFX is open source under Apache 2.0. Clone it, build it, give the skill to your agent. Questions, ideas and effect requests are welcome on GitHub.