Skip to content
thetylerreiffPublic

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Tube

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.

Features

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

Requirements

  • macOS 13 or newer.
  • Xcode Command Line Tools with Swift 6 support.
  • Node.js ^20.19.0 or >=22.12.0 for the marketing site.

Run The Mac App Locally

Clone the repo:

git clone https://github.com/thetylerreiff/Tube.git
cd Tube

Run the Swift tests:

swift test

Build a local app bundle:

scripts/build-app.sh debug

Launch the app:

open Build/Tube.app

For a release-style local build, use:

scripts/build-app.sh release

By default, local app bundles are ad-hoc signed. Production distribution requires a Developer ID Application certificate and notarization.

Run The Site Locally

Install dependencies:

cd site
npm install

Start the local dev server:

npm run dev

Build the static site:

npm run build

Preview the production build:

npm run preview

The site is intentionally separate from the macOS app. It is a small static front end for project/download information.

Release Builds

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-notary

Create the notarytool keychain profile before the first notarized release:

xcrun notarytool store-credentials tube-notary

Privacy

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

Contributing

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 build

License

Tube is released under the MIT License.

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages