Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Butterchurn

БесплатноНе проверен

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

Описание

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

Установка Butterchurn

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/sandraschi/butterchurn-mcp

FAQ

Butterchurn MCP бесплатный?

Да, Butterchurn MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Butterchurn?

Нет, Butterchurn работает без API-ключей и переменных окружения.

Butterchurn — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Butterchurn в Claude Desktop, Claude Code или Cursor?

Открой Butterchurn на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Butterchurn with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории media