dapctl 1.0.0

TUI/CLI sync tool for HiFi Digital Audio Players
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

use serde::{Deserialize, Serialize};

/// Top-level sync profile TOML. See `examples/sync-fiio-m21-flac.toml`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SyncProfile {
    pub schema_version: u32,
    pub profile: ProfileHeader,
    #[serde(default)]
    pub filters: Filters,
    #[serde(default)]
    pub transfer: Transfer,
    #[serde(default)]
    pub transcode: Transcode,
    #[serde(default)]
    pub selective: Selective,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ProfileHeader {
    pub name: String,
    pub source: String,
    pub destination: String,
    pub dap_profile: String,
    pub mode: Mode,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum Mode {
    Additive,
    Mirror,
    Selective,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct Filters {
    #[serde(default)]
    pub include_globs: Vec<String>,
    #[serde(default)]
    pub exclude_globs: Vec<String>,

    // ── Tag-based filters (all optional; require lofty to read audio headers) ──
    /// Include only files whose artist tag matches one of these (case-insensitive).
    /// Empty = accept all artists.
    #[serde(default)]
    pub include_artists: Vec<String>,
    /// Exclude files whose artist tag matches any of these (case-insensitive).
    #[serde(default)]
    pub exclude_artists: Vec<String>,
    /// Include only files whose genre tag matches one of these (case-insensitive).
    #[serde(default)]
    pub include_genres: Vec<String>,
    /// Exclude files whose genre tag matches any of these (case-insensitive).
    #[serde(default)]
    pub exclude_genres: Vec<String>,
    /// Skip files with sample rate strictly below this value (Hz).
    #[serde(default)]
    pub min_sample_rate_hz: Option<u32>,
    /// Skip files with sample rate strictly above this value (Hz).
    #[serde(default)]
    pub max_sample_rate_hz: Option<u32>,
    /// Skip files with bit depth strictly below this value.
    #[serde(default)]
    pub min_bit_depth: Option<u8>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Transfer {
    #[serde(default = "default_verify")]
    pub verify: Verify,
    #[serde(default = "default_true")]
    pub dry_run_default: bool,
    #[serde(default = "default_parallelism")]
    pub parallelism: usize,
}

impl Default for Transfer {
    fn default() -> Self {
        Self {
            verify: default_verify(),
            dry_run_default: true,
            parallelism: default_parallelism(),
        }
    }
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum Verify {
    None,
    SizeMtime,
    Checksum,
}

/// Selective-mode inclusion list. Modified by the TUI and persisted via toml_edit.
/// Ignored when `mode` is `additive` or `mirror`.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct Selective {
    /// Relative directory prefixes to include (album-level paths, e.g.
    /// "Tool/Lateralus"). Empty = sync nothing in selective mode.
    #[serde(default)]
    pub include_paths: Vec<String>,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct Transcode {
    /// Must be `true` for rules to take effect.
    #[serde(default)]
    pub enabled: bool,
    /// Ordered list of format-conversion rules applied during sync.
    #[serde(default)]
    pub rules: Vec<TranscodeRule>,
}

/// A single ffmpeg transcode rule.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TranscodeRule {
    /// Source file extension to match (case-insensitive), e.g. `"DSF"`.
    pub from: String,
    /// Destination extension to produce, e.g. `"FLAC"`.
    pub to: String,
    /// Extra ffmpeg arguments inserted between `-i <input>` and `<output>`.
    /// Example: `"-ar 176400 -sample_fmt s32"`. Empty = let ffmpeg decide.
    #[serde(default)]
    pub params: String,
}

fn default_verify() -> Verify {
    Verify::SizeMtime
}
fn default_true() -> bool {
    true
}
fn default_parallelism() -> usize {
    4
}