Magisk is a suite of open-source tools for customizing Android devices, providing systemless root access (MagiskSU), a module framework, boot image patching (MagiskBoot), init process hijacking (MagiskInit), SELinux policy modification (MagiskPolicy), and Zygisk (code injection into the Zygote process). The system is composed of a native daemon (magiskd) written in Rust and C++ that communicates with an Android management app (Magisk Manager) via Unix sockets. The app is built with Kotlin and Jetpack Compose (modern UI) alongside a legacy XML/DataBinding variant, and includes a stub APK mechanism for hiding the app from detection. Key entry points include the native binaries (magisk, magiskinit, magiskboot, magiskpolicy, resetprop, su) and the Android app's MainActivity and SuRequestActivity. The build system is Gradle with custom plugins, orchestrating compilation of Rust, C++, and Kotlin components. Data flows involve the app fetching module updates from GitHub repositories, downloading and installing modules, managing superuser policies stored in a SQLite database (magisk.db), and logging su requests. The daemon handles root requests, module mounting, denylist enforcement, and Zygisk module loading. External dependencies include the Android SDK, NDK, Rust toolchain, and libraries such as Retrofit, OkHttp, Room, Moshi, Wire, and libsu. The codebase demonstrates high craftsmanship with elegant architecture, reusable components (e.g., a standalone CLI argument parsing proc-macro, a full terminal emulator, a download engine), and non-obvious engineering solutions for low-level system manipulation. However, it carries maintenance risks due to its multi-language complexity, reliance on Android internals, and dual UI codebase.
This repository provides an Android ad-blocking Magisk module (named '去广告' / 'Remove Advertise') that blocks ads at the system level using hosts file redirection, iptables firewall rules, file locking (chattr), and app component disabling (pm). It includes a comprehensive, community-curated blocklist in both hosts file format (all, reward) and Adblock Plus format (adb.txt), targeting Chinese mobile apps and ad networks. The repo also hosts a GitHub Pages website (index.html) for distribution, donation, and version history (over 200 releases). While primarily an application (Magisk module), it has a strong data component in the form of curated blocklists, making it a hybrid project. The module is distributed as flashable ZIP archives in the module/ directory, with an update.json for Magisk's auto-update mechanism. The codebase is functional and well-used (1014 stars) but shows signs of maintenance burden (large version list, incomplete English documentation, history-cleanup workflow that destroys git history).