Skip to content
rulosa01Public

About

An ephemeral web browser for macOS. No history. No cookies. No cache.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

Petrichor

An ephemeral web browser for macOS. No history. No cookies. No cache.

What It Does

Every session starts clean and ends clean. All browsing data lives in memory only — when you quit, everything is destroyed. There's nothing on disk for anyone to find.

  • Ephemeral by default — WKWebsiteDataStore.nonPersistent() across every tab. No cookies, cache, local storage, or session data touches the disk.
  • HTTPS only — all HTTP requests are silently upgraded. javascript:, data:, and file: schemes are blocked.
  • Tab isolation — each tab gets its own WKProcessPool. Tabs can't correlate sessions or exploit cross-tab side-channels (Spectre/Meltdown).
  • No referrer leaks — no-referrer meta tag injected at document start for all frames. Outbound links never reveal the page URL you were on.
  • Fingerprint protection — canvas pixel data randomized per session (2D and WebGL readPixels), WEBGL_debug_renderer_info blocked, WebGL capability queries and extension list spoofed to a generic baseline, AudioContext frequency and time-domain data noised, navigator.hardwareConcurrency and screen dimensions spoofed to common values, SpeechSynthesis.getVoices() returns empty. Device can't be tracked across sessions via browser fingerprinting.
  • WebRTC blocked — RTCPeerConnection is removed before any page JS runs. No STUN/TURN IP enumeration, even behind a VPN.
  • Ad/tracker blocking — built-in EasyList + EasyPrivacy rules compiled from hardcoded data in the binary.
  • No logging — zero os.Logger usage. The unified log gets nothing. Debug output only exists in debug builds via stdout.
  • Reader mode isolation — article extraction runs in a custom WKContentWorld, isolated from page JavaScript. Hostile pages can't detect or interfere with reader mode.
  • Cleanup on quit and launch — destroys temp files, WebKit data stores, saved application state, UserDefaults, and recent documents. Launch cleanup handles crash/force-quit scenarios. Signal handlers (SIGTERM/SIGINT/SIGHUP) and atexit provide additional cleanup coverage. Temp directories use randomized names so /tmp reveals nothing identifiable.
  • Page content cleared on close — innerHTML wiped and blank page loaded before releasing webview on both tab close and hibernation. Reduces forensic recovery of sensitive content from freed RAM.
  • Secure URL bar — custom NSViewRepresentable with autocorrect, spelling, text replacement, quote substitution, and grammar checking all disabled. Typed URLs don't leak into macOS system caches.
  • No favicon fetching — no sideband requests that leak what sites you're visiting.
  • Normalized User-Agent — generic Safari 17 string. One less fingerprinting vector.
  • Download xattr stripping — if you choose to download a file, com.apple.quarantine and kMDItemWhereFroms are stripped so macOS doesn't record where it came from.

What It Doesn't Do

This is not Tor Browser. It doesn't anonymize your network traffic, and it can't protect you from a compromised network. What it does is ensure your device has no evidence of what you were doing. If someone gets your laptop, there's nothing to find.

Known limitations (details in CODE_REVIEW.md):

  • System DNS resolver is used — configure your own DNS-over-HTTPS at the OS level if you need it
  • Government-controlled CAs are trusted via the system trust store

Features

  • Tabbed browsing (up to 500 tabs)
  • Tab groups with color coding
  • Tab hibernation — background tabs auto-unload after 30 minutes (no screenshots stored)
  • Command palette (Cmd+K)
  • Reader mode (Cmd+Shift+R) — clean article view with font/theme controls
  • Focus mode (Cmd+Shift+F) — dims UI, optional Pomodoro timer
  • Certificate inspector — view the full TLS chain (subject, issuer, validity, SHA-256 fingerprint)
  • Redirect chain transparency — see every URL hop during navigation, with tracker and third-party flags
  • HTTP security headers — audit response headers (HSTS, CSP, X-Frame-Options, etc.) with presence/absence indicators
  • Fingerprint activity monitor — connection details show which fingerprinting APIs the page accessed (canvas readback, WebGL identity, audio analysis, etc.) with call counts and explanations
  • DNS detection — identifies your system resolver and warns if it's your ISP's default
  • Per-site JavaScript toggle — block JS on any site with one click, or kill it globally
  • Per-site permissions for camera, mic, location, notifications (session-only, never persisted)

Building

git clone https://github.com/rulosa01/petrichor.git
cd petrichor
open Browser.xcodeproj

Requires macOS 13+ and Xcode 15+. Build and run with Cmd+R.

Tests

xcodebuild test -scheme Browser -destination 'platform=macOS'

License

Licensed under the MIT License.

About

An ephemeral web browser for macOS. No history. No cookies. No cache.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages