explaingit

jbrick2070/resolume-cowork-helper-mcp-automation

Analysis updated 2026-05-18

6PythonAudience · vibe coderComplexity · 4/5LicenseSetup · moderate

TLDR

A kit that lets an AI agent build matching Resolume VJ compositions and APC40 mkII controller layouts, with a ready made verified setup included.

Mindmap

mindmap
  root((repo))
    What it does
      Visual controller twin
      Agent built layouts
      VJ compositions
    Tech stack
      Resolume Arena
      MCP
      MIDI
    Use cases
      Install ready made layout
      Agent driven customization
      Support new controllers
    Audience
      VJs
      Live visual performers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Install a ready made APC40 mkII controller layout that lights up and moves in sync with the physical hardware.

USE CASE 2

Have an AI agent build a custom controller layout for your own Resolume composition using the included prompts.

USE CASE 3

Bring a different MIDI controller and have the agent research its layout and map it automatically.

What is it built with?

PythonResolume ArenaMCPMIDIFFGL

How does it compare?

jbrick2070/resolume-cowork-helper-mcp-automationaclark4life/home-depot-crawlaetheria-labs1/storefront-skills
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity4/52/53/5
Audiencevibe coderdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Resolume Avenue or Arena, an APC40 mkII controller for the stable path, and a Resolume MCP server for the agent driven path.

MIT License: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

In plain English

This project, called apc40mkii-kit, is a kit that lets an AI agent like Claude build visual show compositions and controller layouts inside Resolume, a video performance program used by VJs, through a connection method called MCP. It targets one specific hardware controller, the Akai APC40 mkII, and gives it a full matching visual composition so every button, fader, and knob on the physical controller has a corresponding item on screen that lights up and moves along with it. The stable part of the kit is a verified composition file with 148 controls and a matching MIDI preset with 203 shortcuts, built entirely from Resolume's own built in sources, meaning no extra video clip files are needed to use it. Alongside that is a set of nine copy paste prompts that a person can hand to an AI agent to have it build the same kind of controller layout against their own composition and hardware, or even a different controller entirely, with the agent researching that hardware's layout on its own. An experimental section, kept separate under a beta folder, contains earlier audio reactive compositions and custom video plugins built with the FFGL plugin format. There are two ways to use this. A person who just wants to play can follow a short install guide: download the controller preset file, copy it into a specific Resolume folder, open the included composition file, and turn the APC40 mkII on as both an input and output device inside Resolume's MIDI preferences, which takes about ten minutes with no coding or AI involved. Alternatively, someone who wants an agent to build or customize things can install Resolume, install Claude, connect a Resolume MCP server that lets the agent see and control the software, then copy one of the included prompt files to the agent and watch it carry out the steps, asking before it saves any changes. This is aimed at VJs and people who perform with visuals live, who want a working controller setup without manually building nearly 150 layers and over 200 shortcuts by hand. The project is licensed under MIT, and was tested specifically on Resolume Avenue 7.27 with Resolume MCP 7.26 on Windows 11.

Copy-paste prompts

Prompt 1
Walk me through installing the APC40 mkII controller preset and composition file in Resolume.
Prompt 2
Help me connect a Resolume MCP server to Claude so an agent can see and control my composition.
Prompt 3
Use prompts/01-first-contact.md to check that my agent can see my current Resolume rig.
Prompt 4
Explain how to use prompts/09-any-controller.md to map a different MIDI controller to my setup.

Frequently asked questions

What is resolume-cowork-helper-mcp-automation?

A kit that lets an AI agent build matching Resolume VJ compositions and APC40 mkII controller layouts, with a ready made verified setup included.

What language is resolume-cowork-helper-mcp-automation written in?

Mainly Python. The stack also includes Python, Resolume Arena, MCP.

What license does resolume-cowork-helper-mcp-automation use?

MIT License: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

How hard is resolume-cowork-helper-mcp-automation to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is resolume-cowork-helper-mcp-automation for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.