osx-overlay

⚠️ ARCHIVED PROJECT - This repository is maintained for historical purposes only. Development ceased in 2020.

A proof-of-concept macOS application for livestreaming that displays HTML-based visual overlays on the desktop with MIDI controller integration.

Overview

This project explored creating transparent, click-through web view overlays for single-computer livestreaming setups. The core ideas:

Transparent WebViews: Floating windows using WKWebView with transparency, positioned above streaming software
MIDI Control: Hardware controllers (e.g., Novation Launchpad) trigger overlay visibility for hands-free operation during streams
Click-through Windows: Overlays appear on screen capture but don't block mouse interaction with other applications
HTML-based Content: Overlays are standard HTML/CSS/JavaScript, enabling animations, graphics, and dynamic content

Created: April 2020
Status: Proof-of-concept only, abandoned
Successor: This approach was validated and evolved into cheval, which runs on Raspberry Pi with an external mixer for production use

This repository remains available for historical reference and architectural insights into macOS overlay implementation.

Name		Name	Last commit message	Last commit date
Latest commit History 29 Commits
overlay.xcodeproj		overlay.xcodeproj
overlay		overlay
sample		sample
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md