git404hub

what is chromeless fr?

antiwork/chromeless — explained in plain English

Analysis updated 2026-05-18

264SwiftAudience · developerComplexity · 1/5LicenseSetup · easy

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

SwiftWKWebViewmacOS

how it stacks up fr

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 i run it?

Difficulty · easy time til it works · 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.

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.