Skip to content
This repository was archived by the owner on Nov 27, 2025. It is now read-only.

README.md

Latest commit

 

History

History
23 lines (14 loc) · 1.29 KB

README.md

File metadata and controls

23 lines (14 loc) · 1.29 KB
Raw

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

Timeline & Status

  • 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.