Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Windo

Download the latest Windo.dmg Latest Windo release MIT license Stars

A floating, always-on-top web window for macOS — watch YouTube, live sports, or any non-DRM web video on top of other apps, including over full-screen apps.

A menu-bar utility (no Dock icon). Liquid Glass control pill, ambient title bar that tints to the video, global hotkey, favorites, opacity, and compact mode.

Pause When Hidden (menu-bar toggle, on by default): hiding the window pauses whatever is playing, and showing it again resumes it.

Install

Grab the .dmg from the latest Windo release, or install via Homebrew:

brew install --cask zackbart/tap/windo

Requires macOS 26 (Tahoe) — uses the native Liquid Glass APIs.

Develop

brew install xcodegen
xcodegen generate && open Windo.xcodeproj   # then ⌘R

project.yml is the source of truth; Windo.xcodeproj is generated and gitignored. All app code is one file: Sources/main.swift (AppKit + WKWebView, no dependencies).

Shortcuts

Action Key
Show/hide from anywhere ⌃⌘H
Focus URL ⌘L
Reload ⌘R
Add to favorites ⌘D
Compact mode ⌘.

Drag the title bar to move; hold ⌥ and drag anywhere as a backup. The control pill (bottom-left) expands on hover.

Releasing

Tag-driven. Bump MARKETING_VERSION in project.yml, commit, then:

git tag windo-v0.1.8
git push origin windo-v0.1.8

The repository release workflow builds on macos-26, signs with Developer ID, notarizes + staples, publishes a Windo-<version>.dmg to GitHub Releases, and bumps the Homebrew cask in zackbart/homebrew-tap.

License

MIT