Tube is a minimal native macOS app for watching streaming services in a focused
window. It uses Swift, AppKit, and WKWebView instead of bundling a browser
runtime.
The project is intentionally narrow: it opens each service's website, keeps browser chrome out of the way, and avoids modifying site content or behavior. Tube is not affiliated with any supported streaming provider.
- Native macOS window with standard traffic-light controls.
- Switch between YouTube, YouTube TV, Netflix, Apple TV, Hulu, Twitch, and Audible.
- Native service chooser with
Command-Kand a standard Service menu. - Focused playback with no URL bar or permanent browser toolbar.
- Back, forward, reload, stop, and open-in-browser commands.
- Trackpad back/forward navigation that respects the macOS setting.
- Persistent website sessions and provider-scoped session reset.
- Light and dark appearance support for the native app chrome.
- Small Vite-powered marketing site in
site/.
Streaming providers control browser and DRM compatibility. A service may load successfully but still restrict sign-in, protected playback, resolution, or external-display behavior inside an embedded WebKit view.
- macOS 13 or newer.
- Xcode Command Line Tools with Swift 6 support.
- Node.js
^20.19.0or>=22.12.0for the marketing site.
Clone the repo:
git clone https://github.com/thetylerreiff/Tube.git
cd TubeRun the Swift tests:
swift testBuild a local app bundle:
scripts/build-app.sh debugLaunch the app:
open Build/Tube.appFor a release-style local build, use:
scripts/build-app.sh releaseBy default, local app bundles are ad-hoc signed. Production distribution requires a Developer ID Application certificate and notarization.
Install dependencies:
cd site
npm installStart the local dev server:
npm run devBuild the static site:
npm run buildPreview the production build:
npm run previewThe site is intentionally separate from the macOS app. It is a small static front end for project/download information.
The release helper signs, packages, notarizes, staples, and validates the app:
scripts/release-app.sh \
--identity "Developer ID Application: Your Name (TEAMID)" \
--notary-profile tube-notaryCreate the notarytool keychain profile before the first notarized release:
xcrun notarytool store-credentials tube-notaryTube does not collect credentials, inject scripts, modify streaming sites, or track usage. Provider sign-in happens inside WebKit, and WebKit manages the resulting website sessions. If a provider needs location for local or live programming, macOS asks for permission and WebKit shares it directly with that provider; Tube does not store it.
Issues and pull requests are welcome. Please keep changes aligned with the project scope: a small native Mac streaming wrapper, minimal chrome, and no content injection or scraping.
Before opening a PR, run:
swift test
cd site
npm run buildTube is released under the MIT License.