# Warden

![Warden home screen](docs/screenshots/home.png)

[![Add to Obtainium](https://img.shields.io/badge/Obtainium-Add-222222?logo=android)](obtainium://app/%7B%22id%22%3A%22org.vikingware.webwarden%22%2C%22url%22%3A%22https%3A//git.smesh.lol/webwarden%22%2C%22author%22%3A%22vikingware%22%2C%22name%22%3A%22Warden%22%2C%22preferredApkIndex%22%3A0%2C%22additionalSettings%22%3A%22%7B%22customLinkFilterRegex%22%3A%22%22%2C%22skipSort%22%3Afalse%2C%22reverseSort%22%3Afalse%7D%22%2C%22overrideSource%22%3A%22HTML%22%7D)

Android browser router. Tap a link in any app — instead of being thrown into your default browser, **pick which browser opens it and in what privacy mode**.

Every time. Or save a one-tap Flow and never pick again.

No telemetry. No network calls. `INTERNET` permission stripped from release builds.

## Features

- **Per-link routing** — set Warden as your default browser. Every tap goes through the chooser. Save Flows (browser × privacy mode × optional autolaunch) for one-tap routing.
- **Privacy profiles** — Raw (bare link), Privacy (incognito / ephemeral / max), Work (normal tab with referrer forwarding). Each Flow belongs to one profile; tap the profile tab to filter.
- **Strongest private mode per browser** — Incognito · Ephemeral · Mini (Custom Tabs), automatically selecting the strongest mode the chosen browser supports. Knows the difference between Chromium-class, Firefox, and CCT private intents.
- **URL cleaning** — strips ~50 tracking parameters (`utm_*`, `fbclid`, `gclid`, …) before launch.
- **Privacy proxies** — Twitter → Nitter, YouTube → Invidious, Reddit → Redlib. Tap the cycle glyph to roll between enabled instances. Add custom destinations.
- **Browser encyclopedia** — security and privacy scores for each browser, sourced from [privacytests.org](https://privacytests.org). Per-browser protection breakdowns and mode explanations.

## Supported browsers

Brave · IronFox · Vanadium · Helium · Tor Browser · Firefox · Firefox Beta · Firefox Nightly · Firefox Focus · Felice · DuckDuckGo · Chrome

## Install

| Source | |
|---|---|
| [Releases](https://git.smesh.lol/webwarden/releases) | Signed arme64-v8a APKs |
| [Obtainium](https://github.com/ImranR98/Obtainium) | Auto-update from releases |
| [Zapstore](https://zapstore.dev) | Decentralized app store |

## Use

1. Open Warden → tap **Make Default** → select Warden under Android's default browser app.
2. Tap **+ New Flow** → pick a browser → choose a profile (Raw / Privacy / Work) → save.
3. Tap any link in any app → pick a Flow.

## Donate

Free and open source. Tap **Donate** in the top bar or go to the [donation page](https://nowpayments.io/donation/VFY0DTM) — any cryptocurrency accepted.

## Build

```bash
npm install
npx expo run:android          # debug
./scripts/release-dev.sh       # dev APK (side-loads to phone)
./scripts/release-apk.sh       # signed release APK
./scripts/release-zapstore.sh  # publish to Zapstore
```

Requires JDK 17, Android SDK, Node 18+, NDK 27.1.12297006.

## Releases

| Version | APK | SHA-256 |
|---------|-----|---------|
| [Warden-v1.3.5-dev-ca2b0a9.apk](https://git.smesh.lol/webwarden-releases/raw/releases/v1.3.5-dev-ca2b0a9/Warden-v1.3.5-dev-ca2b0a9.apk) | `v1.3.5-dev-ca2b0a9` | `89feb1e68a99b330af52866d586d9bd48af31c1367b0ec8c2248464706aed8a0` |

## License

MIT