Install

Sideload the signed APK from GitHub Releases.

Steps

  1. Download BLOKD-v1.5.0.apk (direct) or browse all releases.
  2. Open the APK in your browser or Files app and allow installation from that source.
  3. Launch BLOKD, pick Standard or Berserk, and flip the protection switch.
  4. Approve the Android VPN permission prompt. BLOKD needs it to filter DNS locally.
  5. Optionally enable AdGuard DNS-over-TLS for encrypted upstream resolution.

Play Protect

Play Protect may show an "unknown developer" notice for any sideloaded app. The APK is release-signed by CI, so it installs and updates normally once you continue past that notice.

Updating

Download the newer APK and install over the existing app. Your settings are preserved. Blocklists refresh automatically on unmetered networks; tap Update lists in the app to force a refresh.

Build from source

gradle :app:assembleDebug

Release builds are signed by GitHub Actions. See .github/workflows/release.yml.