Repository navigation
π‘οΈ StevenBlock v1.0
StevenBlock was rewritten from scratch, so this brand-new architecture starts a fresh version line at v1.0.
π Highlights
- π₯οΈ Brand-new WebUI β switch lists, update, manage domain rules, check status and read logs from one polished interface.
- βοΈ Fully automatic install β no questions, no volume keys. The installer detects your root manager, checks for conflicts, cleans up old versions and installs the default list.
- π Zero permanent background processes β blocking is a static hosts file, and the local WebUI server only runs while you use it.
- π Backed-up, atomic updates β downloads are validated before they can touch your hosts file, and every write can be rolled back.
- π§ͺ Applied-state check β see at a glance whether your hosts file is β
Applied, π‘ Not applied yet,
β οΈ Overridden by another module or π΄ Not active. - π Works with or without a metamodule β on KernelSU, SukiSU and APatch, StevenBlock checks the mount at every boot and bind-mounts its hosts file itself when the root manager doesn't.
- π Private by design β local only, token-protected, no telemetry, no external requests from the WebUI.
π― New blocklists
- π’ StevenBlack Main β the balanced default (~74K entries)
- π΅ hBlock β a mixed list built from many sources
- π’ HaGeZi Light β basic protection (~155K entries)
- π΅ HaGeZi Normal β all-round protection (~365K entries)
- π‘ HaGeZi Pro β extended protection (~468K entries)
- π HaGeZi Pro++ β aggressive, may break some sites (~521K entries)
- π΄ HaGeZi Ultimate β the most aggressive option (~569K entries)
- π Live entry counts and last-update dates, read from each list's header without downloading the whole file
π₯οΈ WebUI
- π Lists β level badges, entry counts, dates and a clearly marked active list
- β¬οΈ Live progress β download, verify, optimize and install steps with percentage, size, speed and a βοΈ Cancel button
- π§© Domain Rules β β Allow and β Block single domains; paste a full URL and the domain is extracted for you
- β‘ Actions β π Update Current List, π Check Status and β» Disable / Enable Blocker
- π Logs β timestamped, color-coded entries (βΉοΈ INFO,
β οΈ WARN, β ERROR) - π Reboot banner β appears whenever saved changes are waiting for a reboot
- π Dark and βοΈ light themes, built for phones from 360 px up to tablets
- π± Opens inside KernelSU, KernelSU Next, SukiSU and APatch, and from the Action button on Magisk v28+ (or with KsuWebUI, MMRL and WebUI X)
π Safety net
- π Every download must return HTTP 200, can't be empty or an HTML page, must contain at least 1,000 valid entries and must match its Content-Length
- π§Ή One-pass normalization: every entry becomes 0.0.0.0, duplicates and invalid domains are removed
- πΎ The last 3 hosts files are kept as backups
- βοΈ Atomic writes and post-write verification with automatic restore
- π One task at a time, with stale-lock detection
- π Offline install? StevenBlock finishes installing and downloads your list automatically after the next boot
- π§ A missing or damaged hosts file is rebuilt from the cached list at boot
β¬οΈ Upgrading from v5.0
- π» The terminal menu, ποΈ volume-key installer and β‘ Energized lists have been removed
- π§Ή v5.0 leftovers (config.txt, hosts.bak, hosts.tmp) are cleaned up automatically
- π― Everyone starts on StevenBlack Main β pick any other list in the WebUI after rebooting
- π Reboot after the update to activate StevenBlock v1.0