Skip to content

0x536b796ec3b578/abluo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Abluo

A fast, secure, and minimalistic device wiping and formatting tool for removable drives.


⚠️ Disclaimer

DANGER — THIS TOOL PERFORMS DESTRUCTIVE OPERATIONS

Abluo is intended for removable devices only (USB flash drives, SD cards, external disks). Using it on system disks or internal drives can result in irreversible data loss or system corruption.

Always double-check your device path (e.g., /dev/sdb) before running any command.

Abluo does not include any safety prompt beyond the command-line interface. This is by design, to remain minimal and scriptable (though an optional confirmation feature may be added later). You are responsible for verifying that the target device is correct.


Overview

Abluo is a Rust-based utility designed to securely wipe, partition, and format removable storage devices (such as USB drives and SD cards) with safety, performance, and reliability in mind.

Unlike traditional disk utilities, Abluo performs a secure multi-step process that combines cryptographic-grade data erasure, partition table regeneration, and filesystem creation. It aims to provide a simple, scriptable, and transparent CLI workflow for safely preparing external media.


Easy to use

# The simplest of commands, Abluo takes care of everything!
sudo abluo /dev/<device> --auto

# Manually format as FAT32.
sudo abluo /dev/<device> --format fat32

# Manually format as exFAT.
sudo abluo /dev/<device> --format exfat

# Wipe only will leaves partitioning and formatting up to you.
sudo abluo /dev/<device> --wipe-only

Tip: Run as root. On Linux, Abluo will exit with an error if not executed with sufficient privileges.


Dependencies

Abluo relies on several system utilities for low-level disk operations:

Tool Purpose
cryptsetup Encrypted container creation & LUKS header management
blockdev Fetching block size and geometry
parted Partition table and partition creation
mkfs.fat / mkfs.exfat Filesystem creation
dd, wipefs, sync Device writing and metadata cleanup

These dependencies are verified automatically at runtime. If any are missing, Abluo will provide a clear error message before proceeding.


Installation (Linux)

You can build and install Abluo manually using Rust’s cargo:

# 1. Clone the repository
git clone https://github.com/0x536b796ec3b578/abluo
cd abluo

# 2. Build the release binary
cargo build --release

# 3. Optionally, copy the binary to a location in your PATH
sudo cp target/release/abluo /usr/local/bin/

# 4. Verify installation
abluo --version

Tip: If you don’t want to install system-wide, you can run the binary directly from the target/release folder:

./target/release/abluo /dev/<device> -h

Contributing

Contributions are warmly welcomed! Abluo’s goal is to become an open, auditable, and trustworthy storage preparation tool.

Contribution Rules

  • Remove unnecessary dependencies: prefer built-in Rust or core system utilities.
  • Improve execution speed, but never at the cost of reliability or wipe security.
  • Make it cross-platform: macOS, Windows, BSD support are all desired.
  • Add useful features, such as:
    • Disk support (non-removable).
    • Additional formatting schemes.
    • Smart device detection.
    • Enhanced reporting or verification steps.

Before submitting a PR, please run cargo fmt and cargo clippy to maintain consistent formatting and lint standards.


Supporting

Author: Skynõx

If you’d like to support the project:

Bitcoin bc1q87r2z8szxwqt538edzw5gl397c9v3hzxwjw82h
Ethereum 0xe277049067F72E89326c2C0D11333531d5BbB78B

Abluo is latin for “to cleanse, wash, purify”. This tool lives up to its name. It’s a clean, fast, and precise way to prepare removable media with confidence.

About

A fast, secure, and minimalistic device wiping and formatting tool for removable drives.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages