Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Butterchurn

FreeNot checked

MilkDrop-style audio-reactive WebGL visualizer via butterchurn — ~2,000 presets, modern GLSL shaders, BPM sync for mixx-dj-mcp. FastMCP 3.4 + zero-install webap

GitHubEmbed

About

MilkDrop-style audio-reactive WebGL visualizer via butterchurn — ~2,000 presets, modern GLSL shaders, BPM sync for mixx-dj-mcp. FastMCP 3.4 + zero-install webapp for Claude Desktop / Cursor.

README

Just Ruff Python Butterchurn

Music visualizer for the fleet: fullscreen animated eye-candy that dances to your music, Winamp-MilkDrop style, with beat sync to the DJ setup (mixx-dj-mcp).

Universal visualizer toolbox — modern WebGL2 GLSL shaders + legacy MilkDrop presets (butterchurn). FastMCP server with BPM sync for mixx-dj-mcp.

Engines

Engine What When to use
GLSL Shaders 6 bundled WebGL2 scenes (gyroid, tunnel, plasma, …) Modern look, no .milk baggage
Butterchurn 500+ community MilkDrop presets Retro Winamp nostalgia

Open Toolbox in the webapp to switch engines, preview, and go fullscreen.

The Presets page is a live gallery of every visualizer: each thumbnail renders its own animated preview (up to ~12 WebGL contexts at once, cards activate as you scroll) with search, category/author filters, favorites, a slideshow mode, and a one-click fullscreen view.

Preset library: besides the bundled butterchurn packs (Main/Extra/MD1/Minimal/…), it ships projectM's MilkDrop presets — the classic "threads of light" particle and geometric look. ProjectM Original (513) loads eagerly; the large ProjectM Cream Geo (996) and ProjectM Cream Particles (375) packs lazy-load only when you browse them.

The Settings page auto-detects local LLM engines (Ollama / LM Studio / vLLM), picks a model resident-first (never evicting a loaded one), and on multi-GPU machines routes local models to the secondary card via a GPU selector.

How it works

The webapp fills the entire browser window with a WebGL canvas running MilkDrop preset visualizations. The built-in beat generator pulses to the current BPM (default 128). Presets cycle through the butterchurn library — click or use arrow keys to switch.

mixx-dj-mcp integration: Send POST /api/bpm { "bpm": 140 } to the backend at 10878 to sync the visualizer's beat to a DJ set.

Quick start

git clone https://github.com/sandraschi/butterchurn-mcp
cd butterchurn-mcp
uv sync
cd webapp; bun install; cd ..
just serve     # backend on :10878 + MCP HTTP at /mcp

In another terminal:

just web       # Vite dev on :10879

Or use start.ps1 for both at once. It starts the backend (:10878) and the Vite dev server (:10879) as detached background processes, opens the webapp, and returns immediately — no hanging terminal. Requires bun on PATH (or auto-detects the default ~\.bun\bin\bun.exe).

API

Endpoint Method Description
/health GET Server status, version, uptime
/api/bpm GET Current BPM value
/api/bpm POST { "bpm": 140 } Set BPM (mixx-dj-mcp sync)
/api/logs GET Query log entries (limit, level, kind, search, sort, after_id)
/api/logs/stats GET Ring buffer size / max entries
/api/logs/export GET Download logs as JSON or CSV
/api/logs DELETE Clear the log buffer
/api/llm/gpus GET Enumerate NVIDIA GPUs (index, name, VRAM) for target-GPU placement
/api/llm/detect GET Local LLM detection: GPU tier + installed/loaded Ollama models

MCP tools

Tool Description
get_bpm Read current BPM
set_bpm Set BPM for visualizer sync

Ports

Role Port
Backend (FastAPI + MCP HTTP) 10878
Frontend (Vite dev) 10879

Documentation

Doc Contents
Installation All install methods, prerequisites
Product Requirements Goals, requirements, status
Architecture System architecture, data flow, ports
Configuration Env vars, config options
Tool Reference All available tools
Development Contributing, local setup
Troubleshooting Common issues

Requirements

  • Windows / macOS / Linux
  • Python 3.12+ and uv (Option A/C)
  • Bun for the webapp dev server (Option A)
  • A WebGL2-capable browser (Chrome, Edge, Firefox, Safari)

License

MIT

from github.com/sandraschi/butterchurn-mcp

Installing Butterchurn

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sandraschi/butterchurn-mcp

FAQ

Is Butterchurn MCP free?

Yes, Butterchurn MCP is free — one-click install via Unyly at no cost.

Does Butterchurn need an API key?

No, Butterchurn runs without API keys or environment variables.

Is Butterchurn hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Butterchurn in Claude Desktop, Claude Code or Cursor?

Open Butterchurn on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Butterchurn with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All media MCPs