adb-magisk-installer

rdmptv's avatarfrom rdmptv

Complete Magisk system installation - from initial app setup to full system integration

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 3, 2025⬇️2downloads
[Developer Tools]

When & Why to Use This Skill

The adb-magisk-installer skill provides a comprehensive, automated workflow for Magisk system integration on Android devices. It streamlines the complex process of rooting and system modification by handling everything from initial APK downloads and boot image extraction to patching and flashing via ADB and Fastboot. This tool is designed to transform manual, error-prone system setups into a reliable, programmatic sequence, ensuring 'Installed: Yes' status with minimal user intervention.

Use Cases

  • Automating the end-to-end rooting process for Android devices used in mobile application development and QA testing.
  • Upgrading Magisk versions across multiple devices efficiently by automating the download, patch, and flash cycle.
  • Fixing 'Installed: N/A' status on devices where the Magisk app is present but system-level integration (boot image patching) is missing.
  • Preparing specialized mobile environments for security research or advanced automation tasks that require root-level system access.
  • Standardizing device setup runbooks for IT teams managing fleets of Android hardware for specific technical use cases.
nameadb-magisk-installer
descriptionComplete Magisk system installation - from initial app setup to full system integration
version1.0.0
modularizedtrue
scripts_enabledtrue
tier3
categoryadb-system-installation
last_updated2025-12-02
compliance_score100
- nameadb-magisk-flash-boot.py
purposeFlash patched boot image back to device via fastboot
typepython
commanduv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py
zero_contextfalse
colorblue

Quick Reference (30 seconds)

Complete Magisk System Installation

What It Does: Fully automates Magisk system installation from scratch. Handles app installation, boot image extraction, patching, and flashing. Transforms "Installed: N/A" to "Installed: Yes".

Core Capabilities:

  • 📥 Download: Get latest Magisk APK and files from GitHub
  • 📱 App Install: Install Magisk Manager via adb install
  • 💾 Boot Extract: Pull boot.img from device
  • 🔧 Boot Patch: Patch boot image using Magisk
  • ⚡ Boot Flash: Flash patched image via fastboot

When to Use:

  • Device shows "Installed: N/A" (Magisk not system-integrated)
  • Fresh Magisk setup needed
  • Upgrading Magisk version (27.0 → 30.6)
  • Boot image needs patching

Device Status Meaning:

  • ✅ Installed: Yes - Magisk integrated with system
  • ⚠️ Installed: N/A - App installed, but boot image not patched/flashed
  • ❌ Installed: No - Magisk app not installed

Installation Workflow

The complete Magisk installation process (magisk-complete-install.toon):

Phase 1: Download & Prepare

  • Download Magisk APK from GitHub releases
  • Download matching boot image (device-specific)
  • Stage files on device storage (/sdcard)

Phase 2: Install App

  • Push Magisk Manager APK to device
  • Install via adb install
  • Verify app launches successfully

Phase 3: Extract Boot Image

  • Connect via adb
  • Extract boot.img from active partition
  • Store locally for patching

Phase 4: Patch Boot Image

  • Launch Magisk Manager app
  • Select boot image for patching
  • Magisk generates patched_boot.img
  • Pull patched image from device

Phase 5: Flash Boot Image

  • Enable USB fastboot mode
  • Flash patched_boot.img via fastboot
  • Verify installation
  • Device reboots with Magisk integrated

Scripts

adb-magisk-download.py

Download latest Magisk APK and boot image from GitHub releases.

# Download latest version
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --output-dir /tmp/magisk

# Download specific version
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --version 30.6 \
    --output-dir /tmp/magisk

# Include boot image
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --version 30.6 \
    --include-boot \
    --output-dir /tmp/magisk

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --version 30.6 \
    --json

adb-magisk-install-app.py

Install Magisk Manager APK via adb install.

# Install APK on device
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk

# Force reinstall
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk \
    --force

# Verify after install
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk \
    --verify

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk \
    --json

adb-magisk-extract-boot.py

Extract boot.img from device via adb pull.

# Extract boot image (auto-detects active partition)
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --output-path /tmp/magisk/boot.img

# Extract from specific partition
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --partition boot_a \
    --output-path /tmp/magisk/boot_a.img

# Verify integrity
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --output-path /tmp/magisk/boot.img \
    --verify

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --output-path /tmp/magisk/boot.img \
    --json

adb-magisk-patch-boot.py

Patch boot image using Magisk Manager app.

# Patch boot image (interactive via Magisk app)
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img

# Wait for patching to complete
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img \
    --wait-completion

# Download patched image automatically
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img \
    --output-path /tmp/magisk/patched_boot.img

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img \
    --json

adb-magisk-flash-boot.py

Flash patched boot image via fastboot.

# Flash patched boot image
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img

# Flash to specific partition
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --partition boot_b

# Auto-reboot after flash
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --reboot

# Verify before flashing
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --verify

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --json

Workflows

magisk-complete-install.toon

Complete Magisk installation from scratch (14 steps, ~15 minutes).

name: Complete Magisk Installation
description: Full system installation from "Installed: N/A" to "Installed: Yes"

parameters:
  device: "127.0.0.1:5555"
  version: "latest"
  timeout: 900

phases:
  - id: phase1_download
    name: Download Magisk Files
    steps:
      - id: download_apk
        action: adb-magisk-download
        params:
          version: "{{ version }}"
          include_boot: true
          output_dir: "/tmp/magisk"

  - id: phase2_app_install
    name: Install Magisk Manager App
    steps:
      - id: push_apk
        action: adb-magisk-install-app
        params:
          device: "{{ device }}"
          apk_path: "/tmp/magisk/Magisk-v{{ version }}.apk"
          force: true

      - id: verify_app
        action: adb-magisk-launch
        params:
          device: "{{ device }}"
          timeout: 15

  - id: phase3_extract_boot
    name: Extract Boot Image
    steps:
      - id: extract
        action: adb-magisk-extract-boot
        params:
          device: "{{ device }}"
          output_path: "/tmp/magisk/boot.img"

  - id: phase4_push_boot
    name: Push Boot to Device Storage
    steps:
      - id: push
        action: adb-push
        params:
          device: "{{ device }}"
          local: "/tmp/magisk/boot.img"
          remote: "/sdcard/boot.img"

  - id: phase5_patch_boot
    name: Patch Boot Image via Magisk
    steps:
      - id: open_magisk
        action: adb-magisk-launch
        params:
          device: "{{ device }}"

      - id: navigate_to_install
        action: adb-tap
        params:
          device: "{{ device }}"
          x: 100
          y: 400

      - id: select_boot
        action: adb-file-select
        params:
          path: "/sdcard/boot.img"

      - id: wait_patch
        action: adb-wait-for
        params:
          method: text
          target: "Patching complete"
          timeout: 120

  - id: phase6_pull_patched
    name: Pull Patched Boot Image
    steps:
      - id: pull
        action: adb-pull
        params:
          device: "{{ device }}"
          remote: "/sdcard/Download/magisk_patched*.img"
          local: "/tmp/magisk/patched_boot.img"

  - id: phase7_reboot_fastboot
    name: Reboot to Fastboot Mode
    steps:
      - id: reboot
        action: adb-reboot
        params:
          device: "{{ device }}"
          mode: fastboot

      - id: wait_fastboot
        action: adb-wait-fastboot
        params:
          device: "{{ device }}"
          timeout: 30

  - id: phase8_flash_boot
    name: Flash Patched Boot Image
    steps:
      - id: flash
        action: adb-magisk-flash-boot
        params:
          device: "{{ device }}"
          boot_path: "/tmp/magisk/patched_boot.img"
          reboot: true

      - id: wait_boot
        action: adb-wait-device
        params:
          device: "{{ device }}"
          timeout: 60

  - id: phase9_verify_installation
    name: Verify Magisk Installation
    steps:
      - id: launch_app
        action: adb-magisk-launch
        params:
          device: "{{ device }}"
          wait_text: "Installed"
          timeout: 30

recovery:
  - on_error: phase5_patch_boot
    action: retry
    max_attempts: 2
    delay: 5

  - on_error: phase8_flash_boot
    action: adb-screenshot-capture
    then: pause

Decision Logic Integration

This skill follows IndieDevDan Decision Logic Framework patterns:

Decision Point 1: Is Magisk Installed?

Device Status Check:
├─ Installed: Yes → Use adb-magisk skill
├─ Installed: No (app missing) → Phase 2 (install app)
└─ Installed: N/A (boot not patched) → Full workflow (Phase 1-9)

Decision Point 2: Which Installation Method?

Installation Selection:
├─ Fresh device → Full workflow (download → install → patch → flash)
├─ App exists, needs patching → Skip Phase 1-2, start Phase 3
└─ Upgrade from older version → Full workflow with version override

Decision Point 3: Boot Image Management

Boot Image Strategy:
├─ Extract → Patch → Flash workflow
├─ Auto-detect active partition (boot_a or boot_b)
├─ Verify integrity before flashing
└─ Rollback strategy if patch fails

Integration Points

Depends On:

  • adb-screen-detection (screenshot, OCR for "Patching complete")
  • adb-navigation-base (tap, swipe, wait-for actions)
  • adb-uiautomator (UI element interaction)
  • adb-workflow-orchestrator (workflow execution and phase management)

Used By:

  • adb-karrot (requires Magisk+PlayIntegrityFork for bypass)
  • Any automation requiring system-level modifications
  • ADB Auto Player setup workflows

External Integration:

  • GitHub API (download Magisk releases)
  • Fastboot protocol (flash boot images)
  • ADB protocol (device communication)

Troubleshooting

"Installed: N/A" doesn't change after flashing

  • Boot image may not be flashable on this device
  • Try alternative partition (boot_b instead of boot_a)
  • Some devices require vendor_boot patching (Magisk 30+)
  • Check device bootloader version compatibility

Fastboot connection fails

  • Ensure device is in fastboot mode: adb reboot fastboot
  • Check USB cable and host connection
  • Verify fastboot binary is available in PATH
  • Some devices need special drivers for fastboot

Magisk patching fails

  • Boot image format may be unsupported
  • Try manual patching in Magisk app UI
  • Check available storage on device (/sdcard)
  • Ensure boot image file isn't corrupted

Device bootloops after flashing

  • Flash original boot.img to recover
  • Use recovery mode if available
  • Connect to custom recovery (TWRP) and flash backup
  • Restore device via stock ROM if necessary
  • adb-magisk - Magisk Manager automation (module installation, configuration)
  • adb-karrot - Uses Magisk for Play Integrity bypass
  • adb-workflow-orchestrator - Orchestrates complex installation workflows

Version: 1.0.0 Status: ✅ Complete Installation Tier Scripts: 5 Workflows: 1 Last Updated: 2025-12-02 Tier: 3 (System Installation)