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
Описание
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
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
Установка Butterchurn
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/sandraschi/butterchurn-mcpFAQ
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
ARA
Generate images, video and audio from any AI agent — one connector.
автор: ARAOmni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
автор: buildwithtazaYouTube
Transcripts, channel stats, search
автор: YouTubeEverArt
AI image generation using various models.
автор: modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
автор: gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
автор: merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
автор: SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
автор: YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
автор: AceDataCloudAceDataCloud/MCPNanoBanana
Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.
автор: AceDataCloudCompare Butterchurn with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории media
