Cameras, phones, graphics and web pages in, one programme out to YouTube, Facebook, Twitch and your own site at the same time.
When a camera dies mid show, your stream stays up.
Download for Windows · macOS · Linux · Docker · Run it with AI · Website
Every frame is the real app and its real output. Watch it in HD.
- Download the app for Windows, macOS or Linux and open it. No account, nothing else to install.
- Say what you are streaming. A church service, a classroom, a game stream or an empty desk. Change anything later.
- Paste your stream key and press Take. YouTube, Facebook, Twitch or any RTMP address. It turns green and you are live.
Studio mode, transitions, graphics, every destination at once, and a stream that survives a dead camera. These are real recordings of the app beside what viewers got.
Set up the next shot, press Take. Preview on the left, what viewers see on the right, with fade, wipe, dip and more.
More of the app, with narration: the website tour.
Everything above is also something you can ask for. GodwinMix has an MCP server built in, so Claude Code, Codex, Gemini CLI, Cursor or any MCP client can run your show. You ask for the outcome in plain words. The agent picks the graphic, fills it in, builds the scene, takes it to air and checks the programme picture before it answers.
Every clip below is a real session with the waits shortened and account details blanked: the prompt as it was typed, the agent's own reply, and what viewers saw at that moment. Loops play at 2x; click one for the full session in HD.
| For | Ask your agent |
|---|---|
| Church | Show Pastor Grace, Sunday Service, in white on #173b64. |
| Church | Direct these church cameras for one minute. Hold each shot at least eight seconds. |
| School | Put my camera beside the lesson slides and take that layout live. |
| School | Put "Water boils at 100°C at sea level" over my lesson. |
| Sports | Show Falcons 2, Rovers 1, second half, over the match. |
| News | Run headlines from our community RSS feed along the bottom. |
| Events | Show Ana Silva, Product Director, in #0066cc over the webinar. |
| Streamers | Put my webcam over the game, bottom right, with a purple frame. |
| Podcasts | Put both podcast cameras side by side with our names, Jo and Sam. |
| 24x7 channels | Watch for one minute; if the programme freezes, take the healthy backup. |
| Channel operators | Dry run feeds.csv, then start the channels that fit this machine. |
| Developers | Turn the Python colour bars example into a clock source and put it on air. |
- It is free for any use, including commercial, under Apache 2.0, on Windows, macOS and Linux.
- A dead camera or a dropped destination does not take your stream down. The part that sends your picture out starts once and runs until the show ends.
- Multistreaming, phone cameras by link or QR and the browser UI come with it, and NDI and SRT are first party plugins in the installer.
- Anyone on the team can run the show from a browser, a tablet or a phone, several people at once, each with their own undo for scene edits.
- Your AI agent can operate it, design its graphics and keep watch, through the MCP server that ships in the same binary.
- It runs headless on a server, in Docker or on a Raspberry Pi, as well as on a laptop.
- Your OBS scene collection comes across, with a report of anything it skipped.
| You are | Start here |
|---|---|
| A church media team, a teacher, a club or a small event crew | Download the app, then your first stream |
| Coming from OBS | Bring your OBS scene collection across |
| Running shows with a team | Run a show from phones, several operators, Companion and Stream Deck, OSC and tally |
| Running channels on a server | Run it on a server, monitor many shows, Raspberry Pi |
| Building with AI agents | Connect your agent |
| Scripting it | Drive it from the command line |
| A developer who wants to embed or extend it | Build on it |
With GodwinMix open on the same machine, your agent needs no address and no token.
claude mcp add godwinmix -- godwinmix mcp
godwinmix skill install --for claude # or opencode, pi, codex, geminiOr skip the terminal: Help > Connect an AI agent in the app has a Set up button for Claude Code, opencode, pi, Codex, Gemini CLI, Cursor and VS Code.
The agent sees the whole show in one labelled picture, every camera plus the programme, so it compares shots in a single look before it acts.
The playbook for agents is docs/agents.md. A working director built on the Anthropic SDK is examples/ai-director.py. Setup per agent: connect an AI agent.
One container, one port, no screen. This puts a web page on air to a local RTMP server, so it needs no stream key to try.
git clone https://github.com/psmux/GodwinMix && cd GodwinMix
docker compose -f deploy/docker/docker-compose.yml up -d --buildOpen http://localhost:8080 for the mixer and http://localhost:8888/live/program to watch what goes out. To stream somewhere real:
docker run -d --name godwinmix --shm-size 1g \
-p 127.0.0.1:8080:8080 -e GODWINMIX_TOKEN=change-me \
ghcr.io/psmux/godwinmix:latestThe full walk through is your first stream with Docker. Before the port is reachable from anywhere else, read deploy/README.md for the token, TLS and the firewall.
Everything the window does is one call, and gmx is the short command for it.
gmx ctl status
gmx ctl source add roof https://host/stream.m3u8 --name "Roof camera"
gmx ctl output add youtube rtmp://a.rtmp.youtube.com/live2/KEY
gmx ctl take roofEvery command is in the CLI reference and every endpoint in the HTTP API reference.
GodwinMix is one Rust binary on GStreamer. The same binary is the server, the CLI and the MCP server, and the web UI uses the same public API as everyone else.
- Embed the engine in your own program with
cargo add godwinmix-core: how to embed it. - Write a plugin that runs beside the core: your first plugin, scaffolded by
gmx plugin new. - Theme the UI with CSS variables: add a theme.
- API level 1 is frozen for breaking changes, and an old level stays supported for a year after a new one.
Start with CONTRIBUTING.md and the architecture. The measured results, the pipeline, platforms and hardware are in technical details and why the programme never stops.
| Tutorials | your first stream on the desktop, in a browser, with Docker or from a preset |
| How to | one task each: graphics, phones, ad breaks, screen capture, NDI, SRT, monitoring many shows |
| Reference | sources, the HTTP API, the CLI, plugins, presets |
| Explanation | why GodwinMix is built the way it is |
| Technical details | install paths in depth, verification, hardware, platforms and known limits |
Apache 2.0, in LICENSE. Contributions are under the CLA and the code of conduct. Security reports go to the address in SECURITY.md, not to a public issue.
GodwinMix is not affiliated with, endorsed by or connected to the OBS Project. OBS, OBS Studio, Open Broadcaster Software and the OBS Studio logo are registered trademarks of Wizards of OBS LLC, and are used here only to describe what this software reads.
Upgrading from LiveboxMix, which is what this was called until 0.2: docs/how-to/upgrade-from-liveboxmix.md.














