Skip to content

About

Turn a DJ set (WAV/AIFF) into a beat-synced, YouTube-ready music video, styled by a template.

Resources

Code of conduct

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Three stills from setrender videos: an 8-bit rave on a burned-out car stage, a first-person crowd at a farm festival under an aurora, and a 1930s rubber-hose cartoon of a pepper shaker and a rye loaf fighting a teapot

setrender

Your DJ set, as a music video that dances to it.
Give it a WAV or AIFF, pick a world, and get a YouTube-ready video where every kick, hi-hat, breakdown and drop moves something on screen.

Watch · Quick start · Gallery · Cookbook · How it works · Contributing

macOS on Apple Silicon Python 3.11+ Output: YouTube-ready 1080p60 Runs locally, no cloud License: MIT Definition of done: automated checks


Five worlds, one command

knisper: pixel-art crowd dancing in front of a burned-out car DJ stage cropcircle: a 3D crowd of pixel people at night under an aurora, jellyfish glowing in the trees rubberhose: two cartoon heroes squaring up to a giant angry red teapot spume: an eight-fold kaleidoscope of bubbles holding lightning around a ring of frost and smaller bubbles cymatics: golden sand gathered into the nodal lines of a square Chladni plate
knisper
An 8-bit underground rave. A burned-out car is the DJ booth, jellyfish hang in blocky trees, and a crowd of every kind bounces on a lit dancefloor, with nods to the C64, Amiga, Mega Drive, N64 and NES.
cropcircle
A night at a farm festival, seen first-person in 3D, from sunset to sunrise. UFOs lay crop circles, a drone flies the fields, people arrive through the corn, dance, queue for the loos and go home.
rubberhose
A 1930s rubber-hose cartoon boss rush with original characters. One boss per act, hearts, ghosts, lost takes, super attacks on the drops, intermissions in the breakdowns and an easter egg every minute.
spume
Alien foam, falling forever into itself. Bubbles inside bubbles in the colours of real soap films, kaleidoscopes fading in and out, and fire, water, earth, air, metal, ice, lightning and magma in alternating bubbles. No characters, no letters.
cymatics
Sound made visible. A physics lab at night, filmed in macro: sand on a Chladni plate, Faraday waves, ferrofluid spikes, a Rubens tube of flames, water frozen by a strobe and lasers drawing the chord of the key, all played by the set.

Everything on screen answers to the music: the beat tracker finds every kick, five frequency bands drive different things on screen, the set's sections change the scenery, and the drops land. The same set always renders the same video, and two different sets never look alike.

Watch it

Play the 30-second rubberhose highlight reel on YouTube: the Jelly Queen towers over the two heroes in a farm orchard Play the two-minute rubberhose reel on YouTube: DJ Hamhock, a purple pig DJ with dragon wings, under festival lasers Play the full-length cropcircle video on YouTube: a pixel-art crowd dancing under lasers and bunting at night
▶ 30 seconds of rubberhose
A trailer for the boss rush, cut by setrender reel with every cut on a beat.
▶ Two minutes of rubberhose
One clip per boss on its best moment, from setrender reel --per-act --length 120.
▶ The whole set in cropcircle
Pepper & Pumpernickl at Knisper Festival 2026, from sunset to sunrise.

All three were rendered by setrender from the same DJ set. Watch with the sound on: every kick, drop and breakdown is doing something.

Try it in five minutes

You need a Mac with Apple Silicon, Homebrew and a DJ set as WAV or AIFF.

brew install uv git
git clone https://github.com/dnk8n/setrenderer.git && cd setrenderer
./install.sh

Render a 30-second preview from ten minutes into your set (tip: type the command, then drag your audio file into the Terminal window to paste its path):

.venv/bin/setrender render "my set.wav" --start 600 --duration 30
open out/

Happy with it? Drop --start and --duration to render the whole set. A two-hour set takes about 40 to 65 minutes on an M1 Pro, keeps the machine responsive, and picks up where it left off if you stop it.

New to the Terminal? Getting started walks through every step, including uploading to YouTube.

A taste of what you can ask for

setrender render set.wav -t rubberhose                          # the cartoon boss rush
setrender render set.wav -t cropcircle -k aurora,packed         # keywords switch on looks
setrender render set.wav -t spume -k mirror,acid                # psychedelic foam, kaleidoscopes all night
setrender render set.wav -t cymatics -k plates                  # sand, waves and ferrofluid played by the set
setrender render set.wav -k acid --seed 3                       # another take on the same set
setrender render set.wav --set elements.crowd.count=80          # change any value in a template
setrender still  set.wav -t rubberhose --at 60,600,3600         # snapshots before you commit
setrender reel   set.wav -t rubberhose --per-act --length 30    # a beat-cut trailer, one clip a boss
setrender render set.wav --resolution 2160p --audio-codec aac   # 4K, as a small MP4
setrender render set.wav --cpu 4                                # stay gentle while you work

(Inside the repo folder, setrender is .venv/bin/setrender, or run source .venv/bin/activate once.)

Six versions of the same moment in knisper: the default, and with the keywords acid, c64, amiga, night plus packed, and a different seed
The same second of the same set in knisper: the default, four keyword looks, and --seed 7.

The cookbook has a recipe for each of these and more: highlight reels, 4K, lossless masters, batch renders, reproducing a render from its receipt, and checking a video against the criteria.

Every set looks like itself

Two different 30-second test sets rendered with the same templates at the same moment: different palettes, crowds, heroes and bosses
Two different 30-second test sets (cut from different hours of a mix), same templates, same moment, no settings changed.

The variation seed is built from the audio itself, so palettes, crowds, stages, casts and running orders differ from set to set, while the set's tempo, key, energy and structure drive the motion. Render the same set twice and you get the same video, frame for frame. Want a different take? Change --seed.

Hidden in the videos

Things to look out for, without spoiling all of them:

  • a cow with a cowbell, but only when Apple's on-device sound classifier actually hears a cowbell in your set (cropcircle)
  • the Konami code at bar 1337, and someone missing at bar 404 (cropcircle)
  • a skeleton playing its ribs at bar 1929 and a steamboat at bar 1928, for the cartoons of those years (rubberhose)
  • a film burn at bar 404, a ghost when it hears a theremin, and 26 kinds of easter egg, about one a minute and never the same one twice in ten minutes (rubberhose)
  • thirteen bosses, from a gramophone in a ballroom to a pig DJ who turns into a dragon (rubberhose)
  • light that changes colour with the key of the music, around the circle of fifths, and bubbles that blaze when the classifier hears their instrument: brass sets fire to them, keys turn them to water, bells to bismuth (spume)
  • sand that settles on the nodal lines of a harmonic of your set's key, by Chladni's law, and three lasers drawing the key's chord, major or minor (cymatics)

Six rubberhose moments: the title card, a Super Art, a ghost floating up, a TAKE 2 clapperboard, a KNOCKOUT card and the overworld map

The full lists are on each template's page.

How it works, in one picture

flowchart LR
  A["Your set"] --> B["Listen<br/>beats, bands,<br/>sections, sounds"]
  B --> C["Plan<br/>signals per frame,<br/>the set's own seed"]
  T["Template"] --> C
  C --> D["Draw<br/>frame i,<br/>CPU or GPU"]
  D --> E["Encode<br/>media engine,<br/>resumable chunks"]
  E --> F["Video<br/>+ receipt"]
Loading
  • Free and local. ffmpeg, librosa, NumPy/SciPy, pygame-ce and wgpu, all open source and all on your machine. Nothing is uploaded anywhere.
  • Deterministic. Each frame depends only on its number, the audio and the settings, so renders are reproducible, parallel and exact to the frame.
  • Kind to your computer. --cpu caps the load the render adds (7 by default on an 8-core Mac), frames are drawn on the GPU where the template allows, and the hardware encoder does the compression.
  • Resumable. Work is saved in one-minute chunks. Stop it, reboot, run the same command, and it carries on.
  • Measured, not eyeballed. What "done" means is written down as criteria, and scripts check each one. The templates in the box pass all of their automated checks.

Read how it works for the full pipeline.

Go deeper

I want to... Read
install it and make my first video, step by step Getting started
see every template and what to look out for Templates
find a recipe for a specific task Cookbook
look up a command, an option or an output file Reference
understand the pipeline and why it is built this way How it works
make my own template Make a template
know what "complete" means and how it is checked Criteria
fix a bug, add a feature or a whole new engine Contributing
point my coding agent at this repo AGENTS.md

Make it yours

A template is a plain YAML file: palettes, which frequency band drives which element, how many people are in the crowd, which bosses fight, and keywords that bundle a look. Copy one, change it, and render with -t path/to/yours.tpl. When YAML is not enough, a new engine is a Python module that draws frame i. Make a template shows both.

Contributing

Ideas for new worlds, bug reports, docs fixes and code are all welcome, and so are contributions made with AI coding agents, as long as a person stands behind them. Start with CONTRIBUTING.md. Agents can read AGENTS.md, which most coding agents pick up on their own.

Requirements

Tested on macOS on Apple Silicon (M1 Pro, 16 GB)
Other systems untested; knisper with --encoder x264 is the likeliest to work, and the sound-cued gags need macOS
Disk about 10 to 20 GB per two hours of 1080p60 at the default quality; the render checks before it starts
Time for a 2 h set about 40 min (knisper), 60 min (cropcircle), 65 min (rubberhose), 65 min (spume) or 55 min (cymatics) on an M1 Pro
Installs ffmpeg (Homebrew), uv, and pinned Python packages in a local .venv

Credits

Built on the shoulders of ffmpeg, librosa, NumPy, SciPy, pygame-ce, wgpu-py and Apple's on-device SoundAnalysis classifier. rubberhose is a love letter to 1930s rubber-hose animation and to the games it inspired; its characters, stages and lettering are original.

License

setrender is released under the MIT License: use it, change it, build on it and ship what you make, commercially or not, as long as the copyright notice comes along. The videos you render from your own music are yours.

The tools it runs on keep their own licenses (ffmpeg is LGPL/GPL and installed separately through Homebrew, pygame-ce is LGPL, and librosa, NumPy, SciPy and wgpu-py use permissive licenses).

About

Turn a DJ set (WAV/AIFF) into a beat-synced, YouTube-ready music video, styled by a template.

Resources

Code of conduct

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages