Ultra-Lightweight, Lightning-Fast Native WebKit Viewer for macOS
A privacy-focused, borderless, zero-distraction web viewer built natively with pure Swift and WebKit. Not your standard browser.
- Blazing Fast: Native implementation utilizing
WKWebViewunder the hood. No Chromium bloat, minimal RAM usage. - Aggressive Ad-Blocking: Built-in surgical content blockers utilizing compiled rule lists alongside custom localized DOM observers.
- SPA-Aware Architecture: Advanced context-aware proxy. Blocks intensive autoplays on Home Pages (like Twitch) but seamlessly permits content on inner routes.
- Distraction-Free Mode: Immersive mode right out of the box with
HiddenTitleBarWindowStyle. No clutter. - Custom User Agent: Easily spoof user agent strings via custom configuration to bypass anti-bot detections.
- Keyboard & Native Driven: Deep shortcuts (
Cmd+/Cmd-), Middle-click isolation for window spawning, and fluid navigation.
No bloated Xcode projects here. Build the entire application organically via CLI tools:
# 1. Clone the project
git clone https://github.com/your-username/awv-mlx.git
cd awv-mlx
# 2. Compile into an application MacOS binary
swiftc -parse-as-library AWV.swift -o AWV.app/Contents/MacOS/AWV
# 3. Ad-Hoc sign the application locally
codesign --force --deep --sign - AWV.app
# 4. Deploy to Applications
cp -a AWV.app /Applications/Crafted entirely in high-performance Swift using Apple's Declarative UI. We eschew XIB files and Xcode bloat in favor of a zero-calorie compilation workflow.
- Frontend: SwiftUI (
WindowGroup,LazyVGrid,ZStack) seamlessly integrated with AppKit features. - Core Engine: Apple's
WebKit(WKWebView,WKNavigationDelegate) fully decoupled via SwiftUINSViewRepresentable. - Security & Blocking: Pre-compiled
ContentRuleListblocking, fortified with surgically-injected JavaScript payload observers.
Feel free to open issues or PRs! Let's keep it beautifully minimalist.
Crafted with ✨ for the macOS Ecosystem