Skip to content

Repository files navigation

Sentinel Browser

AGPL-3.0 community privacy browser — clearnet + Tor, Google-free search, ads/trackers blocked by default.

Maintainer: drmikecrypto
Repo: https://github.com/drmikecrypto/sentinel-browser
Releases: https://github.com/drmikecrypto/sentinel-browser/releases

Path 1: system WebView + native chrome + real arti Tor — not a Chromium fork like Helium. We compete on Tor-native honesty, not engine fork size.

What works (production-oriented Path 1)

Area Behavior
Pages WebView under native chrome (WebView2 on Windows; WebKit elsewhere)
Tor / Direct arti SOCKS; WebView rebuilds when switching modes (URL restored)
.onion SOCKS path; searchable via Ahmia
Search Tantivy + seed crawl + Ahmia; optional SENTINEL_SEARX_URL — never Google
Shields adblock-rust + EasyList/EasyPrivacy-inspired lists; sentinel://shields allowlist
DNS Quad9 DoH / DNS-over-Tor for Vortex fetch; Direct WebView uses OS/WebView DNS; Tor WebView via SOCKS
Privacy WebRTC blocked; WebView2 tracking prevention by security level; fingerprint not claimed
Sandbox Windows Job Object (kill-on-close + memory limit)
Updates Chrome Update when newer; download + SHA256 verify (SHA256SUMS) → *.new beside binary
Circumvention Bridges file + paste; PT helpers on demand

Download (v0.0.3+)

Grab platform binaries from Releases.

Windows builds are unsigned unless repo secrets WINDOWS_CERT_PFX (base64 PFX) and WINDOWS_CERT_PASSWORD are set. Apple notarization is not wired. Packaging helpers: scripts/packaging/.

Not user-facing until real

I2P, WireGuard, demo V2Ray (unless V2RAY_PATH + SENTINEL_V2RAY_HOST/PORT), on-chain DAO, HSM/PKCS#11, PQC-TLS / Zygote.

Build from source

git clone https://github.com/drmikecrypto/sentinel-browser.git
cd sentinel-browser
cargo build --release
cargo run --release

Optional env:

Variable Purpose
SENTINEL_SEARX_URL Your SearXNG base URL (never Google)
V2RAY_PATH + SENTINEL_V2RAY_HOST / PORT Real V2Ray SOCKS outbound
SNOWFLAKE_CLIENT_PATH / OBFS4PROXY_PATH / LYREBIRD_PATH Override PT binary paths
SENTINEL_TOR_BUNDLE_URL / SENTINEL_TOR_BUNDLE_VERSION Override Tor Expert Bundle used by Install PT helpers

Pluggable transports (on demand)

PT helpers are not shipped inside the browser binary or release zip. From Connect → Install PT helpers (sentinel://install_pt), Sentinel downloads the official Tor Expert Bundle for your OS/arch from archive.torproject.org and extracts lyrebird / snowflake-client into %AppData%/sentinel/pt (or XDG data dir).

Put bridge lines in the app config dir bridges.txt (or sentinel://add_bridge_line?line=…). Without PT binaries, Tor bootstraps direct only.

Downloads land under Downloads/SentinelDownloads. Find-in-page: Ctrl+F or F3. Bookmark: ★ in chrome.

License

AGPL-3.0 — see LICENSE. Trademark notes: docs/GOVERNANCE.md.

About

AGPL privacy browser: Tor + clearnet, Google-free Horus search, adblock shields

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages