|
| 1 | +<!DOCTYPE html> |
| 2 | +<html lang="en"> |
| 3 | +<head> |
| 4 | + <meta charset="UTF-8"> |
| 5 | + <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 6 | + <title>diskfmt</title> |
| 7 | + <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/water.css@2/out/water.css"> |
| 8 | +</head> |
| 9 | +<body> |
| 10 | + <header> |
| 11 | + <h1 style="text-align: center;">diskfmt</h1> |
| 12 | + <p>A disk formatting utility for Linux that feels like the Windows format dialog, built on top of the UDisks2 system service.</p> |
| 13 | + </header> |
| 14 | + |
| 15 | + <main> |
| 16 | + <section> |
| 17 | + <h2>What it does</h2> |
| 18 | + <ul> |
| 19 | + <li>Small, easy defaults aimed at people coming from Windows.</li> |
| 20 | + <li>Filters out non-removable devices to avoid accidents.</li> |
| 21 | + <li>Defaults to GPT tables (you can switch to MBR in the UI).</li> |
| 22 | + <li>Creates a partition before formatting and prefers exFAT when available.</li> |
| 23 | + </ul> |
| 24 | + </section> |
| 25 | + |
| 26 | + <section> |
| 27 | + <h2>Download</h2> |
| 28 | + <p>Grab the AppImage build (requires UDisks2/Polkit on the host):</p> |
| 29 | + <p style="text-align: center;"> |
| 30 | + <button type="button" onclick="window.location.href='https://github.com/MoAlyousef/diskfmt/releases/download/v0.1.3/diskfmt-0.1.3-x86_64.AppImage'"> |
| 31 | + Download diskfmt AppImage |
| 32 | + </button> |
| 33 | + </p> |
| 34 | + </section> |
| 35 | + |
| 36 | + <section> |
| 37 | + <h2>Screenshot</h2> |
| 38 | + <p style="text-align: center;"> |
| 39 | + <img src="https://raw.githubusercontent.com/MoAlyousef/diskfmt/main/screenshots/diskfmt.png" alt="diskfmt application window" style="max-width: 100%; height: auto;"> |
| 40 | + </p> |
| 41 | + </section> |
| 42 | + |
| 43 | + <section> |
| 44 | + <h2>How to use it</h2> |
| 45 | + <p>Start the GUI with no arguments or with <code>--start-ui</code>. Common CLI flows:</p> |
| 46 | + <ul> |
| 47 | + <li>List removable devices: <code>diskfmt list</code></li> |
| 48 | + <li>Format a device: <code>diskfmt format --path /dev/sdb1 --fs vfat --label USB --quick</code></li> |
| 49 | + <li>Pick a filesystem block size or table type with <code>--size</code> and <code>--table</code>.</li> |
| 50 | + </ul> |
| 51 | + <p>Install <code>exfatprogs</code> if you need exFAT support on your distribution.</p> |
| 52 | + </section> |
| 53 | + |
| 54 | + <section> |
| 55 | + <h2>Building</h2> |
| 56 | + <p>Requires Rust, a C++17 compiler, and common FLTK/X11 build dependencies (libx11-dev, libxft-dev, libxrender-dev, etc.). Build a release binary with:</p> |
| 57 | + <pre><code>cargo build --release</code></pre> |
| 58 | + <p>Use <code>--features fltk/use-wayland</code> to build with hybrid/X11 support or <code>--no-default-features</code> for a CLI-only build.</p> |
| 59 | + </section> |
| 60 | + </main> |
| 61 | +</body> |
| 62 | +</html> |
0 commit comments