dap-tui: ratatui device-sync dashboard

Full rewrite of dap-sync as a Rust TUI on ratatui: - Tokyo Night theme, gradient title rule, rounded panels - Devices sidebar with live mount status + last-sync age - Dashboard / Sync / Logs / Config tabs - Live sync engine: rclone mirror, NFC-aware diff, rsync progress parsing, podkit + mlove (fatsort) finalize - Abort-safe subprocess handling, persisted sync state
2026-08-22 09:26:15 +02:00
commit 16a5a4327e
18 changed files with 4972 additions and 0 deletions
@@ -0,0 +1,91 @@
+# dap-tui
+
+A terminal UI for device sync of portable music players, rewritten from scratch
+in Rust on top of [ratatui](https://ratatui.rs/).
+
+It mirrors the StorageBox masters library into your local music directory, then
+syncs a device profile — the same pipeline as the Python `dap-sync`, now as a
+living dashboard instead of a batch CLI.
+
+## Highlights
+
+- **Tokyo Night** palette, rounded panels, gradient title rule, status & key
+  bars.
+- **Devices sidebar** — live mount status (green dot = mounted), firmware tags,
+  last-sync age per device.
+- **4 tabs** — Dashboard (device + library cards, source-chain diagram), Sync
+  (live step pipeline + progress gauge), Logs (color-coded, follow mode),
+  Config (syntax-coloured TOML).
+- **Live sync engine** — streams `rclone` and `rsync` output, parses progress,
+  NFC-aware diffing for macOS→FAT32/Android devices, optional `fatsort`
+  finalize for Mlove devices.
+- **Abort-safe** — `a` kills the running child process cleanly.
+- Reads the existing `~/.config/dap-sync/config.toml` (compatible with
+  `dap-sync`), persists last-sync state to `~/.local/share/dap-sync/sync-state.toml`.
+
+## Install / run
+
+```bash
+cargo build --release
+./target/release/dap-tui            # uses ~/.config/dap-sync/config.toml
+./target/release/dap-tui --config /path/to/config.toml
+./target/release/dap-tui --skip-mirror   # skip the StorageBox → local mirror step
+```
+
+## Keybindings
+
+| Key          | Action                       |
+| ------------ | ---------------------------- |
+| `↑`/`↓` `j`/`k` | move selection             |
+| `s` / `Enter`| sync selected device         |
+| `a`          | abort running sync           |
+| `Tab` / `1-4`| switch tab                   |
+| `r`          | refresh device mounts        |
+| `f`          | toggle log follow            |
+| `u` / `d`    | scroll logs                  |
+| `x`          | clear logs                   |
+| `?` / `h`    | help overlay                 |
+| `q` / `Esc`  | quit                         |
+
+## Configuration
+
+`dap-tui` reads the standard `dap-sync` config format:
+
+```toml
+[paths]
+local_music_dir = "~/Music"
+local_hoerspiele_dir = "~/hoerspiele"
+
+[storagebox]
+source = "storagebox:masters"
+exclude = ["/Music/**", ".DS_Store", ".localized"]
+
+[[devices]]
+name = "iPod Rockbox"
+firmware = "rockbox"
+mount_point = "/media/sebastian/IPOD"
+music_folder = "Music"
+```
+
+Firmware types: `apple` (podkit command), `rockbox`, `android` (rsync),
+`mlove` (rsync + `fatsort`). Devices with `content_type = "hoerspiele"` sync
+against the hoerspiele library.
+
+## How the sync pipeline works
+
+1. **Mirror** — `rclone sync` (or local `rsync`) pulls the StorageBox source
+   into the local library.
+2. **Diff** — the device is scanned and compared to the source with
+   NFC-normalised paths, size, and 2-second-rounded mtimes (FAT32 friendly).
+3. **Sync** — stale files are removed first, then `rsync --files-from` copies
+   only what changed, with live per-file progress.
+4. **Finalize** (mlove) — unmounts the volume and runs `fatsort` via
+   `sudo -n` to keep FAT directory order stable. If passwordless sudo is not
+   available the step is reported as a warning and the commands are printed.
+
+## Development
+
+```bash
+cargo test      # parser + config tests
+cargo run
+```