whatisgithub

What is chromeless?

antiwork/chromeless — explained in plain English

Analysis updated 2026-05-18

264SwiftAudience · developerComplexity · 1/5LicenseSetup · easy

In one sentence

A tiny one-file macOS browser with no tabs or toolbar, built for clean screenshots and fullscreen video, controlled entirely by keyboard shortcuts.

Mindmap

mindmap
  root((chromeless))
    What it does
      Chrome free browser window
      Fullscreen video and dashboards
      CLI screenshot mode
    Tech stack
      Swift
      WKWebView
      macOS
    Use cases
      Clean app screenshots
      Kiosk style dashboards
    Audience
      macOS users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Take clean, distraction free screenshots of a webpage or dashboard.

USE CASE 2

Watch fullscreen video or run a kiosk style display with no browser chrome.

USE CASE 3

Capture a local development site as a PNG from the command line.

USE CASE 4

Pin a small always on top window for a live dashboard.

What is it built with?

SwiftWKWebViewmacOS

How does it compare?

antiwork/chromelesskhr898/ntfsmaclcharvol/macsift
Stars264259240
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity1/53/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Xcode Command Line Tools to build, passkey support needs an optional Apple Developer entitlement.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Chromeless is a tiny macOS app that strips away everything a normal web browser shows you. There is no address bar, no tabs, no toolbar, no visible window buttons at all. The window simply shows the webpage itself, which makes it useful for taking clean screenshots, watching fullscreen video, or displaying a dashboard without any distracting browser interface around it. Under the hood it is a single Swift file built on WKWebView, the same web engine Safari uses. There is no Electron and no external dependencies, and the finished app is only about 450 kilobytes once built. You build it by running a build script, which produces a Chromeless.app you can open directly or move into the Applications folder, and building requires the Xcode command line tools to be installed first. All of the browser's controls are done through keyboard shortcuts rather than visible buttons. There are shortcuts for typing a URL, moving the window by dragging anywhere on it, going fullscreen, saving a screenshot of the page to the desktop, pinning the window above other apps, moving back and forward, zooming, copying the current URL, and reloading the page. The hidden traffic light window controls reappear if you hover the top left corner. Chromeless also remembers the last page you had open and reopens it next time, and it keeps cookies and logins saved so sites like YouTube stay signed in. Beyond being a browser window, the same app can be run from the command line to turn any webpage into a PNG screenshot, which is handy for capturing local development sites or any page at a specific size. The README also explains a more advanced, optional setup involving an Apple developer account and code signing that allows passkey login support to work natively, though the app functions fine without it and simply falls back to alternative sign in methods on sites that support them. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Show me the keyboard shortcuts for controlling this Chromeless browser window.
Prompt 2
Walk me through building Chromeless.app from source with the build script.
Prompt 3
Explain how to use the command line screenshot mode to capture a webpage.
Prompt 4
Help me understand the optional passkey and code signing setup for this app.

Frequently asked questions

What is chromeless?

A tiny one-file macOS browser with no tabs or toolbar, built for clean screenshots and fullscreen video, controlled entirely by keyboard shortcuts.

What language is chromeless written in?

Mainly Swift. The stack also includes Swift, WKWebView, macOS.

What license does chromeless use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is chromeless to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is chromeless for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.