Sebastian
16a5a4327e
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
92 lines
3.2 KiB
Markdown
92 lines
3.2 KiB
Markdown
# 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
|
|
```
|