Skip to content

fparted Documentation 💾

Welcome to the official manual and technical documentation for fparted!

fparted is a modern, high-reliability storage and partition management application engineered specifically for rooted Android devices, Android-x86, Bliss OS, and Linux.

Whether you're looking to partition a high-speed MicroSD card for your custom ROM, format a USB OTG drive with exFAT for cross-platform file transfers, repair a corrupted ext4 filesystem, or make a bit-for-bit raw image backup of your Android recovery partition, fparted brings desktop-grade storage tools directly to your device.

🎯 What Can You Do with fparted?

🛡️ The fparted Safety Promise

Partitioning tools operate directly on raw hardware blocks. A single misplaced sector offset or broken shell argument can permanently destroy operating system partitions or personal memories.

To protect your hardware and data, fparted is built upon five strict safety invariants:

  1. Two-Phase Operations Queue: No command runs immediately when you click a button. Actions are staged into an undoable virtual queue and previewed on the interactive partition graph. You can inspect every step before confirming.
  2. Zero Shell String Interpolation: Feature widgets never execute raw terminal commands or concatenate unquoted strings. All arguments are passed as typed vectors, centrally POSIX single-quoted, and executed with a deterministic environment (LC_ALL=C, PATH=/data/data/vn.shadichy.parted/files/usr/bin).
  3. Cryptographically Verified Toolchain: All native utilities (parted, e2fsprogs, dosfstools, etc.) are linked specifically for Android's Bionic C library and verified against SHA-256 manifests. System $PATH or untrusted toybox builtins are never substituted.
  4. Strict Root Gate: The application tests the exact canonical path /system/bin/su upon startup. Missing root triggers a non-dismissible Exit dialog to protect against undefined behavior.
  5. Deterministic Integer Math: The partition graph allocator uses pure integer largest-remainder (Hare-Niemeyer) mathematics, mathematically guaranteeing zero layout overflows across any screen resolution or aspect ratio.
  • How to Use (Step-by-Step User Guides): Friendly, tutorial-style walkthroughs for first-time launch, managing partitions, formatting drives, backing up raw images, and working with encrypted volumes.
  • Architecture & Safety Invariants: Deep technical breakdown of the startup state machine, root probe contracts, Repo A release assets, and command execution pipelines.
  • Storage & Device Discovery: How fparted probes hardware block devices (MMC, UFS, NVMe, USB, loop devices) and validates canonical paths.
  • Partitions & Layout Mathematics: Detailed explanations of GPT/MBR partition tables, 3-case move algorithms, and sector alignment.
  • Filesystem Capabilities: Full matrix detailing create, label, check, repair, grow, and shrink support across 15+ filesystems.
  • Troubleshooting & FAQ: Answers to common questions, root authorization tips for KernelSU/APatch/Magisk, and error code references.
  • Upstream Credits: Recognizing the foundational open-source engineering from Termux, GNU Parted, e2fsprogs, Flutter, and the Linux kernel storage community.