dap-tui/README.md

dap-tui

A terminal UI for device sync of portable music players, rewritten from scratch in Rust on top of ratatui.

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

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:

[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

cargo test      # parser + config tests
cargo run