Skip to content
View HongMix's full-sized avatar
  • Seoul, South Korea

Block or report HongMix

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
HongMix/README.md

HongMix icon

HongMix

A free live streaming & broadcast switcher for Mac. Native on every Apple Silicon Mac (M1 and later). No Windows box required.
vMix-style layout · vMix-compatible API · SRT · RTMP · NDI® · DeckLink

⬇️ Download HongMix 2.1.0  ·  한국어  ·  Feedback

If macOS shows “Move to Trash” or “Cancel” on first launch: open System Settings › Privacy & Security, scroll down and click Open Anyway. Advanced users can instead run xattr -dr com.apple.quarantine /Applications/HongMix.app. HongMix is ad-hoc signed and not yet notarized.

Latest update · 2.1.0

  • New video inputs no longer loop by default; change this in Settings › General.
  • Fit, Fill and Stretch modes plus separate horizontal/vertical zoom support wide LED walls and non-16:9 sources.
  • HongMix now quits correctly even while a settings sheet is open.
  • Mac sleep is reported as a warning instead of dropped frames, and STREAM blinks orange while disconnected.
  • Verified: loop defaults, fit modes, X/Y zoom and quit paths. Physical lid sleep and the orange disconnected indicator were not directly tested. See the English release notes or 한국어 릴리스 노트.
HongMix 2.1.0 default loop setting for new videos
New videos play once by default · looping is optional
HongMix 2.1.0 Fit Fill Stretch and separate axis zoom
Fit · Fill · Stretch · separate horizontal/vertical zoom
More HongMix interface screenshots
HongMix 2.0.5 main switcher with generated test patterns
Main switcher · generated test patterns
HongMix 2.0.5 PTZ control window
Independent multi-camera PTZ control
HongMix 2.0.5 new input types
Photos, PDF Slides and Virtual Set inputs
HongMix 2.0.5 recording safety settings
Backup recording and disk rollover
HongMix 2.0.5 stream monitor
Per-destination stream health
HongMix 2.0.5 MIDI settings
MIDI learn, templates and LED tally

1.4.2

  • Display output fixed for macOS Spaces: Output Window and borderless Display Fullscreen stay on the active desktop. The green button fills the current display without creating a stranded black full-screen Space; Esc, double-click or right-click returns to a window.
  • Focused output settings: Record, External (NDI / DeckLink) and Stream each have their own settings window. External also routes Output 2–4; Stream includes dual-path backup controls.
  • Monochrome operator skin: a restrained black-and-white skin uses colour only for Preview, Program, ON AIR and warnings. The original skin remains available in Settings.
  • Monitoring workflow: Display settings, Replay and Scopes are now direct bottom-bar controls. Statistics & Monitoring runs in an independent movable window.
  • Validated: the display regression suite passed 16/16 steps in both normal and macOS full-screen switcher states. Multi-display hardware testing is still pending.
  • Public screenshots use generated test patterns only—no people, third-party programme footage or stream keys. See the English release notes or 한국어 릴리스 노트.
HongMix 1.4.2 Monochrome main switcher with generated test patterns
Monochrome switcher · generated 59.94p test patterns
HongMix 1.4.2 Display Output settings
Output Window / Display Fullscreen and source selection
HongMix 1.4.2 Statistics and Monitoring window
Independent Statistics & Monitoring window
HongMix 1.4.2 External output settings
NDI / DeckLink and Output 2–4 routing
HongMix 1.4.2 Stream settings
Dedicated RTMP/SRT settings and dual-path backup stream

Your MacBook is now a switcher.

For years, the answer to "can I run my live show on a Mac?" was "get a Windows PC."

HongMix changes that. It is a live production switcher written from scratch for Apple Silicon:

  • Metal for the picture
  • VideoToolbox for encoding
  • CoreAudio for the sound

No Windows PC. No virtual machine. No Rosetta.

Open the lid. Plug in your camera, your SRT feed and your NDI sources. Go live.

  • 1.5 ms average render per frame at 1080p59.94, 0 dropped frames on an M‑series Mac
  • Zero setup: FFmpeg, SRT, the NDI® runtime and a Chromium web engine are all inside one installer
  • Your muscle memory still works: the layout, the shortcuts and the HTTP/TCP API follow vMix, so Bitfocus Companion and Stream Deck connect as they are

Why I built this

Hi, I'm Hong Seunghoon (홍승훈), a broadcast engineer from Korea. I work on live productions, SRT/LiveU remote contribution and the systems behind them.

I love the Mac. And I love vMix. For many of us it's the tool that taught us how live production should feel. HongMix is built with deep respect for it: vMix was my reference for the layout, the workflow and the API. I wanted that same experience on the machine I carry every day.

I didn't build this to sell anything. I built it for broadcast engineers around the world who have wished, at least once, that their Mac could do the job. Now it's in your hands. Please break it, push it, and tell me what you think.

I love broadcasting, and I love technology. I respect your opinions. — Hong Seunghoon

Program output (1080p59.94)
Program output (1080p59.94)

What's inside

Area Features
Inputs Cameras & capture cards (FaceTime, iPhone Continuity, USB HDMI), SRT listener/caller/rendezvous, RTMP server, URL/UDP/HLS, NDI®, Blackmagic DeckLink, media files with transport bar, list (playlist) input, colour/transparent, images, 24 title templates, screen capture, web browser (Chromium, with audio), audio devices
Switching Cut, 4 transition slots, T‑bar, stingers, 4 overlay channels, FTB, triggers, rundown (cue sheet), scheduler
Picture Metal GPU compositing, layers (2/4/9/16‑split, PIP) with drag‑to‑position, colour correction, chroma key, 3D LUTs (.cube), scopes (waveform, RGB parade, vectorscope, histogram)
Audio Master + buses A–G, EQ / compressor / gate / delay, auto ducking, EBU R128 LUFS meter, headphone monitor
Output RTMP / SRT streaming with dual path and return feed, recording (H.264 / HEVC / ProRes) with multitrack audio, broadcast delay + DUMP, MultiCorder ISO recording, NDI out, DeckLink out, fullscreen
Ops tools Pre‑flight check, SRT link dashboard, incident blackbox, live captions (CC), countdown titles that start on air
Control vMix‑compatible HTTP 8088 / TCP 8099 API, phone tally, web remote, access control (IP allow list, password)
Language English / 한국어, switchable live

Tested so far

Confirmed working on Apple Silicon:

  • SRT in/out
  • RTMP in/out
  • NDI® send/receive (NDI 6)
  • Built-in FaceTime camera, iPhone camera and a low-cost USB HDMI capture card are detected
  • Blackmagic DeckLink: SDK build integration and input/output configuration are implemented; physical hardware validation is pending
  • Web browser input with audio
  • Media and list playback
  • H.264 recording with multitrack audio
  • Layers and LUTs
  • Broadcast delay
  • vMix-compatible API with Companion-style clients

Please help test. It's a beta, and I can only test what's on my desk:

  • Your capture cards and cameras
  • Real-world SRT / RTMP / NDI links (LiveU, OBS, other switchers)
  • Companion / Stream Deck
  • Multi‑hour shows
  • Other Mac models

"It works on my M2 Air with an Elgato" is a great report too. → Open an issue

FAQ

I use vMix on Windows. Can I work the same way on a Mac? HongMix borrows vMix's layout and API with deep respect, so the workflow feels familiar on a Mac. It isn't meant to replace vMix, which is an excellent product. It's for the times when all you have is a MacBook.

Is there a free live switcher for MacBook with SRT and NDI? Yes, that's exactly what HongMix is:

  • SRT listener/caller in and out, with link stats
  • NDI® in/out
  • RTMP in/out
  • Recording
  • All in one free installer

Does it work with Bitfocus Companion and Stream Deck? Yes. HongMix speaks the vMix HTTP (8088) and TCP (8099) API, so the Companion vMix module connects by pointing it at your Mac's IP.

Can I use LiveU / SRT feeds, capture cards, DeckLink or an iPhone as a camera?

  • SRT feeds (e.g. LiveU): connect as caller or listener.
  • Blackmagic DeckLink: SDK integration and input/output configuration are implemented; physical hardware validation is pending.
  • USB HDMI capture cards: standard (UVC) cards show up as cameras. A low-cost USB card has been confirmed; Elgato, Magewell and others should work the same way, and reports are welcome.
  • iPhone: works via Continuity Camera.

Is it OBS? No. OBS is a great streaming encoder. HongMix is a production switcher in the vMix tradition: Preview/Program, transitions, overlays, multi-bus audio, titles and a control API.

Which Macs? Any Apple Silicon Mac on macOS 14 or later. Intel Macs are not supported.

Install

  1. Download the latest HongMix DMG or PKG from Releases. Requires macOS 14+ and an Apple Silicon Mac.
  2. Double‑click it and install.
  3. The first time you open HongMix, right‑click it in Applications → Open → Open. It isn't notarized by Apple yet, so macOS asks once.

Manuals: docs/HongMix-Manual-EN.txt (English) · docs/HongMix-설명서.txt (Korean)

macOS permissions

HongMix asks macOS the first time you use each feature (System Settings › Privacy & Security):

Feature Permission
Desktop Capture input, system audio Screen & System Audio Recording
Camera / capture-card input Camera
Audio Input (microphone, interface) Microphone
NDI discovery, remote control Local Network

After switching a permission on, quit and reopen HongMix; macOS applies screen recording only when an app starts.

Desktop Capture says "Screen Recording permission needed" although HongMix is switched on? macOS ties the permission to the app's signature. Releases are ad-hoc signed (not notarised yet), so after an update macOS may treat HongMix as a new app while System Settings still shows the old "HongMix" switched on. Fix it once per update:

  1. Quit HongMix.
  2. In Terminal: tccutil reset ScreenCapture com.hongseunghoon.HongMix (clears HongMix's entry only).
  3. Open HongMix, add Desktop Capture, choose Open System Settings and switch HongMix on.
  4. Quit and reopen HongMix.

Build from source

xcode-select --install                 # Command Line Tools (Xcode not required)
./scripts/build-ffmpeg-lgpl.sh         # LGPL FFmpeg → build/ffmpeg-lgpl (once)
./scripts/build-cli.sh                 # → build/cli/HongMix.app
./scripts/make-dmg.sh                  # → build/dist/HongMix-<version>.dmg / .pkg

make-dmg.sh signs ad-hoc by default. To keep macOS permissions across your own local builds, create a code-signing certificate, set it to Always Trust for code signing in Keychain Access and build with SIGN_ID="<certificate name>". Don't use a self-signed certificate for public releases: Macs that don't trust it won't apply Screen Recording permission.

Optional SDKs (not included in this repository):

  • NDI SDK for Apple: accept its license yourself
  • Blackmagic DeckLink SDK: see ThirdParty/DeckLinkSDK/README.md
  • CEF for the web browser input: scripts/fetch-cef.sh

Remote control & security

HTTP 8088 / TCP 8099 are open on the local network, like vMix. Use Settings › Network › Remote control security to limit them:

  • Network / this Mac only / off
  • IP allow list
  • Web/HTTP password

Cross‑site requests from other websites in a browser are always blocked.

Feedback

Bugs, ideas, "this is awkward", "this saved my show": everything is welcome in Issues. My e‑mail isn't published here to avoid spam.

License & notices

  • Third‑party components: docs/THIRD-PARTY-NOTICES.txt
  • FFmpeg is built as LGPL v3 (no GPL parts) and dynamically linked.
  • NDI® is a registered trademark of Vizrt NDI AB. HongMix is not a product of NDI.
  • DeckLink is a trademark of Blackmagic Design Pty Ltd.
  • vMix is a trademark of StudioCoast Pty Ltd. HongMix is an independent project, made out of respect for vMix, and is not affiliated with or endorsed by StudioCoast. No vMix code or assets are used.

Popular repositories Loading

  1. HongMix HongMix Public

    Free live streaming & broadcast switcher for Mac — native on every Apple Silicon Mac (M1 and later). SRT, RTMP, NDI®, DeckLink, multi-camera, titles, recording. vMix-style layout & API, works with …

    Swift 5 1