Chromeless is a minimal macOS browser built on WKWebView that removes all interface chrome, providing a distraction-free window and a CLI screenshot tool.

Stars

267

7-day growth

No data

Forks

21

Open issues

0

License

MIT

Last updated

2026-07-03

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It achieves a truly browserless experience in a single Swift file (~450 KB) without Electron, offering native performance and a unique combination of fullscreen browsing, pinned windows, and automated screenshot capabilities.

Who it is for

  • Web developers needing accurate page screenshots
  • Designers capturing clean webpage visuals
  • Dashboard users wanting fullscreen or always-on-top views
  • Minimalist users seeking a no-chrome browsing experience

Use cases

  • Taking Retina-quality PNG screenshots of web pages via keyboard shortcut or CLI
  • Watching YouTube in fullscreen without any browser UI
  • Pinning a dashboard or live chart window above other apps
  • Automating webpage snapshots in scripts with configurable size and wait time

Strengths

  • Extremely lightweight (~450 KB) with no Electron or external dependencies
  • Native macOS performance using Safari's WKWebView engine
  • Keyboard-driven interface with intuitive shortcuts for navigation, zoom, and snapshots
  • Built-in CLI mode for headless screenshot automation

Considerations

  • macOS only; no Windows or Linux support
  • No tabs, bookmarks, history UI, or extensions by design
  • WebAuthn/passkey support requires Apple Developer Program membership and manual entitlement setup

README quick start

chromeless

The browser that isn't there. The window is the webpage — no tabs, no toolbar, no address bar, no chrome at all. Made for clean screenshots, fullscreen YouTube, dashboards, and anything else that deserves the whole window.

A native macOS app in one Swift file, built on WKWebView (the Safari engine). No Electron, no dependencies, ~450 KB built.

Build

./build.sh        # → Chromeless.app
open Chromeless.app

Requires the Xcode Command Line Tools (xcode-select --install). Optionally mv Chromeless.app /Applications/.

Use

Everything is a keystroke (also listed on the start page and in the menu bar):

KeysAction
⌘LSearch or enter a URL (floating HUD)
⌘dragMove the window from anywhere
⌃⌘FFullscreen (YouTube's own ⛶ button works too)
⇧⌘SSnapshot the page as PNG → Desktop
⌘PPin the window above everything
⌘[ / ⌘]Back / forward (two-finger swipe also works)
EscBail out — back to the start page (⌘[ returns)
⌘= ⌘- ⌘0Zoom in / out / reset (pinch works too)
⇧⌘CCopy the current URL
⌘R / ⇧⌘RReload / reload ignoring cache
⌘N / ⌘WNew window / close window

The traffic-light buttons exist but stay invisible — hover the top-left corner to reveal them. The window remembers its frame and reopens your last page.

CLI screenshot mode

Chromeless doubles as a webpage-to-PNG tool:

./Chromeless.app/Contents/MacOS/Chromeless https://example.com --snap shot.png --size 1440x900
./Chromeless.app/Contents/MacOS/Chromeless localhost:3000 --snap dev.png --wait 3

It loads the page, waits for it to settle, writes a Retina PNG, and exits.

Notes

  • Cookies and logins persist (kept in ~/Library/WebKit/com.chromeless.app/), so YouTube stays signed in.

Passkeys

Apple gates WebAuthn in WKWebView behind the restricted com.apple.developer.web-browser.public-key-credential entitlement, and macOS kills ad-hoc builds that claim it without an Apple-issued provisioning profile (verified: instant SIGKILL). Chromeless checks its own signature at runtime:

  • Default build (no entitlement): the WebAuthn API is hidden, so sites feature-detect the absence and offer their fallbacks instead of a doomed passkey prompt. For Google, "Try another way" → "Get a prompt on your phone" signs you in with no pas

Description

The browser that isn't there — zero-chrome macOS browser for clean screenshots and fullscreen video. One Swift file.

Related repositories

Similar projects matched by category, topics, and programming language.

drumih
drumih GitHub avatar

turbo-fieldfare

TurboFieldfare is a custom Swift and Metal runtime that runs the Gemma 4 26B-A4B instruction-tuned model in about 2 GB of RAM on Apple Silicon Macs, including 8 GB models, by streaming experts from SSD.

Swift
256
FrigadeHQ
FrigadeHQ GitHub avatar

yap

Yap is a blazing-fast, on-device macOS voice dictation app that transcribes speech into any text field via a global shortcut, using Apple's macOS 26 Speech APIs with no network calls or model downloads.

Swift
197
jcranokc
jcranokc GitHub avatar

app-monitor

App Monitor is a local-first macOS utility that provides a native SwiftUI dashboard for tracking application usage, storage, cleanup opportunities, update status, and uninstall impact.

Swift
156