dapctl

see it in action

how it works

1. 1.eject microSD from your DAP
2. 2.connect via card reader
3. 3.dapctl scan—detect and identify
4. 4.dapctl diff—preview changes before touching anything
5. 5.dapctl sync—safe copy via temp+rename

why dapctl?

Generic tools don't know anything about your DAP. rsync knows nothing about FAT32 filename limits, your device's supported codecs, or the cache folders its firmware leaves behind. Library managers like beets are excellent, but require adopting an entire library-management workflow just to move files onto a microSD card.

• Filesystem limits — FAT32/exFAT filename and path-length limits, checked before you copy
• Per-device profiles — codec matrix, layout quirks, and firmware exclusion globs for each DAP
• Cache-aware — skips the junk folders DAP firmware leaves behind
• Preview first — dapctl diff shows exactly what would change before anything is written
• More than sync — audits your library, fetches and embeds cover art, and includes a full TUI music player, so you rarely need to leave the terminal

features

• DAP-aware profiles — per-device filesystem limits, codec matrix, layout quirks, firmware exclusions
• Safe by default — dry-run first, temp+rename copy, per-run JSONL manifest for auditability
• Cross-platform — Linux · macOS · Windows, exFAT / FAT32 / NTFS
• TUI + CLI — interactive terminal UI or fully scriptable with --yes / --dry-run
• Modes — additive (never deletes) or mirror (exact replica)
• Tag-based filters — include/exclude by artist · genre · sample rate · bit depth via lofty
• Transcode pipeline — ffmpeg rules (e.g. DSF→FLAC) with blake3-keyed cache; re-encodes only when source changes
• M3U export — dapctl export m3u generates a DAP-ready playlist from the same filters as sync
• Checksum verify — blake3 streaming hash detects silent corruption even when size and mtime match
• TUI audio player — library browser (artist → album → track), gapless playback, HiFi display (sample rate · bit depth · bitrate · channels), / incremental search, source toggle library ↔ DAP, synced lyrics (.lrc), play history + resume
• Library normalisation — case and diacritic-insensitive grouping; "Kings Of Leon" / "kings of leon" and "Rosalía" / "Rosalia" merge into one entry
• dapctl audit — offline library health report: missing tags, absent cover art, format mix, track-number gaps; human table + --json
• dapctl cover fetch — batch downloads folder.jpg via MusicBrainz → Cover Art Archive → iTunes fallback; 30-day cache; opt-in --online flag
• dapctl cover embed — writes cover art into FLAC, MP3, M4A, OGG, and Opus track tags from folder.jpg
• SSH source — source = "ssh://user@host/path" in sync profiles; uses your existing ~/.ssh config, keys, and agent; zero extra dependencies
• 7 builtin DAP profiles — FiiO M21 · FiiO M11 · AK SR35 · HiBy R6 · Shanling M3 Ultra · iBasso DX320 · Generic; all CI-validated
• GPLv3 — no telemetry, offline by default, no lock-in

install

# pre-built binaries — Linux · macOS · Windows
$ github.com/marturojt/dapctl/releases/latest

# from source (requires Rust 1.80+)
$ cargo install --git https://github.com/marturojt/dapctl --tag v1.0.1

# Homebrew (macOS / Linux)
$ brew tap marturojt/tap
$ brew install dapctl

# AUR / Scoop — coming soon
# yay -S dapctl-bin                   (AUR)
# scoop install dapctl                (Scoop)

Pre-built static binaries for Linux (x86_64 + aarch64), macOS (universal), and Windows are available on the releases page. Source install requires Rust 1.80+ (rustup.rs).

what dapctl is not

• Not a tag editor — use MusicBrainz Picard or beets
• Not a duplicate finder or library manager
• Not a music streaming client or cloud sync tool
• No DLNA, AirPlay, or network streaming
• No telemetry, no analytics — network calls only when you pass --online (cover fetch / audit)

status

v1.0.1 released — fixes a crash on any filename containing multibyte Unicode characters (e.g. Mitternachtslöwe.flac); five string-truncation helpers replaced with char-boundary-safe code; dependency security updates (crossbeam-epoch, anyhow).

v1.0.0 — SSH source (ssh://user@host/path),dapctl cover embed (write cover art into track tags), dapctl profile delete(CLI + TUI with two-press confirm), 5 new builtin DAP profiles (7 total, all CI-validated), path-limit warnings from DAP firmware spec, typed error taxonomy with structured exit codes,NO_COLOR support, selective mode write-back, 54 tests.

v0.4.0 — synced lyrics (.lrc auto-scroll), play history + resume position, sleep timer, equalizer animation, library normalisation (case + diacritics), dapctl audit (offline library health: missing tags · absent covers · format mix · track gaps),dapctl cover fetch (MusicBrainz → Cover Art Archive → iTunes, opt-in--online, 30-day cache), TUI UX improvements across player · diff · wizard · profiles.

v0.3.0 — TUI audio player with SQLite-backed library browser (artist → album → track, tag-grouped), gapless playback, HiFi metadata display (sample rate · bit depth · bitrate · channels), / incremental search, source toggle library ↔ DAP destination, home landing screen.

v0.2.0 — blake3 checksum verification, tag-based filters (artist · genre · sample rate · bit depth), ffmpeg transcode pipeline with blake3-keyed cache, dapctl export m3u, 39 tests.

v0.1.0 — sync engine, TUI (profiles · diff · progress · log · wizard), real-world validated: 2,108 FLAC · 75 GB · HiBy R4 microSD.