Chromeless 是一个极简 macOS 原生浏览器，核心理念是“没有浏览器外壳”：窗口本身就是网页，没有标签页、工具栏、地址栏等 UI。它基于 WKWebView（Safari 内核）实现，用 Swift 编写，项目非常轻量，构建后约 450 KB，适合用于干净截图、全屏播放视频、展示仪表盘、网页演示和命令行网页截图。
适用领域
macOS 原生应用 / 浏览器工具 / 网页截图 / 全屏展示 / Swift 开发 / WKWebView / 开发者工具 / 演示与展示工具
配置难度
低到中等。普通用户只需安装 Xcode Command Line Tools 并执行 build.sh 即可构建运行；熟悉 macOS 命令行的开发者上手很快。如果要修改源码、签名分发或启用 Passkeys/WebAuthn，则需要了解 Swift、macOS App 打包、codesign、Apple provisioning profile 等知识，难度会提升到中等或偏高。
商业价值
该项目适合用于内部工具、演示工具、网页截图流水线和轻量级展示场景。对于前端团队、设计团队和产品团队，它可以降低制作干净网页截图和演示页面的成本；对于开发者，它提供了一个非常简洁的 WKWebView/macOS App 示例，可作为定制浏览器壳、Dashboard 展示器或自动截图工具的起点。由于项目轻量、MIT 授权、无复杂依赖，二次开发和集成成本较低，但不适合作为完整商业浏览器产品的基础。
01
技术亮点
- 极简设计：没有标签页、工具栏、地址栏，适合无干扰展示
- 原生 macOS 应用：基于 Swift 和 WKWebView，体积小、启动快
- 无 Electron：避免 Electron 应用常见的体积和资源占用问题
- 一份 Swift 文件实现，代码结构非常适合学习和二次开发
- 支持常用快捷键：输入 URL、全屏、截图、置顶、前进后退、缩放、复制 URL 等
- 支持 CLI 网页截图模式，可指定窗口尺寸、等待时间并输出 Retina PNG
- Cookie 和登录状态可持久化，适合长期使用某些网页服务
- MIT 许可证，商业和个人项目中使用限制较少
02
目标用户
- 需要干净网页截图的设计师、产品经理和开发者
- 需要展示网页仪表盘或大屏页面的团队
- 需要无干扰全屏播放 YouTube 或网页视频的 macOS 用户
- 希望使用轻量级浏览器容器运行单个网页的用户
- 需要通过 CLI 自动生成网页 PNG 截图的前端开发者
- 学习 Swift、WKWebView、macOS App 打包的开发者
03
配置要求
- 操作系统：macOS
- 开发工具：Xcode Command Line Tools
- 运行依赖：无 Electron、无外部依赖，使用系统 WKWebView
- 构建方式：通过仓库内 build.sh 脚本构建
- 截图权限：首次使用 ⇧⌘S 保存到桌面时，可能需要授权桌面访问权限
- Cookie 存储：登录状态保存在 ~/Library/WebKit/com.chromeless.app/
- Passkeys/WebAuthn：默认构建不包含受限 entitlement，WebAuthn API 会被隐藏
- 如需 Passkeys：需要加入 Apple Developer Program，申请 com.apple.developer.web-browser.public-key-credential 能力，并使用 Apple 签名证书和 provisioning profile 构建
04
适用场景
- 生成无浏览器工具栏、无地址栏的网页截图
- 在 macOS 上全屏播放 YouTube 或其他网页视频
- 将本地开发页面如 localhost:3000 渲染为 PNG 图片
- 用于产品页面、Landing Page、Dashboard 的演示
- 把网页当作独立窗口长期置顶显示
- 快速构建一个基于 WKWebView 的极简 macOS 浏览器原型
- 在 CI 或本地脚本中调用应用二进制进行网页截图
05
部署与配置
- 确保系统为 macOS，并安装 Xcode Command Line Tools：xcode-select --install
- 克隆仓库：git clone https://github.com/antiwork/chromeless.git
- 进入项目目录：cd chromeless
- 执行构建脚本：./build.sh
- 构建完成后会生成 Chromeless.app
- 运行应用：open Chromeless.app
- 可选：将 Chromeless.app 移动到 /Applications/ 目录中方便日常使用
- 命令行截图示例：./Chromeless.app/Contents/MacOS/Chromeless https://example.com --snap shot.png --size 1440x900
06
风险与注意事项
- 功能有意保持极简，不适合替代完整浏览器使用
- 缺少标签页、下载管理、历史记录 UI、扩展、页面内查找等常规浏览器能力
- 仅适用于 macOS，不适合 Windows 或 Linux 用户
- 基于 WKWebView，某些网页行为可能与 Chrome/Chromium 不完全一致
- Passkeys/WebAuthn 默认不可用，如需完整支持需要 Apple Developer Program 和特殊 entitlement
- 项目星标数量较小，社区规模有限，长期维护活跃度需要自行评估
- 如果用于自动化截图，复杂动态页面可能仍需调节等待时间或处理加载状态
- 安全能力主要依赖系统 WebKit 和应用自身实现，不应把它当作完整安全浏览器使用
2026-07-07
第29名
新收录 · github_search
2026-07-06
第28名
新收录 · github_search
2026-07-05
第30名
新收录 · github_search
