headroom 2.0.0

Audio loudness analyzer and gain adjustment tool for mastering workflows
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

use anyhow::{anyhow, Result};
use std::collections::BTreeSet;
use std::path::{Path, PathBuf};
use walkdir::WalkDir;

const LOSSLESS_EXTENSIONS: &[&str] = &["flac", "aiff", "aif", "wav"];
const MP3_EXTENSIONS: &[&str] = &["mp3"];
const AAC_EXTENSIONS: &[&str] = &["m4a", "aac", "mp4"];

pub fn scan_audio_files(dir: &Path) -> Vec<PathBuf> {
    WalkDir::new(dir)
        .into_iter()
        .filter_map(|e| e.ok())
        .filter(|e| e.file_type().is_file() && is_audio_candidate(e.path()))
        .map(|e| e.path().to_path_buf())
        .collect()
}

/// Resolve a list of input strings (file paths, directories, globs) into a
/// deduplicated, sorted list of audio files.
pub fn resolve_inputs(inputs: &[String]) -> Result<Vec<PathBuf>> {
    let mut collected: BTreeSet<PathBuf> = BTreeSet::new();

    for input in inputs {
        let path = PathBuf::from(input);

        if path.is_dir() {
            for file in scan_audio_files(&path) {
                collected.insert(file);
            }
            continue;
        }

        if path.is_file() {
            if is_audio_candidate(&path) {
                collected.insert(path);
            }
            continue;
        }

        // Treat as glob pattern (supports e.g. "*.mp3", "music/**/*.flac")
        let mut matched_any = false;
        for entry in glob::glob(input)
            .map_err(|e| anyhow!("Invalid glob pattern '{}': {}", input, e))?
        {
            let p = entry.map_err(|e| anyhow!("Glob error for '{}': {}", input, e))?;
            if p.is_dir() {
                for file in scan_audio_files(&p) {
                    collected.insert(file);
                }
                matched_any = true;
            } else if p.is_file() && is_audio_candidate(&p) {
                collected.insert(p);
                matched_any = true;
            }
        }

        if !matched_any {
            return Err(anyhow!(
                "No matching audio files for input: '{}'",
                input
            ));
        }
    }

    Ok(collected.into_iter().collect())
}

fn is_audio_candidate(path: &Path) -> bool {
    let filename = path.file_name().and_then(|n| n.to_str()).unwrap_or("");
    if filename.starts_with("._") {
        return false;
    }
    is_supported_audio_file(path)
}

fn is_supported_audio_file(path: &Path) -> bool {
    has_extension(path, LOSSLESS_EXTENSIONS)
        || has_extension(path, MP3_EXTENSIONS)
        || has_extension(path, AAC_EXTENSIONS)
}

pub fn get_supported_extensions() -> Vec<&'static str> {
    let mut exts: Vec<&str> = LOSSLESS_EXTENSIONS.to_vec();
    exts.extend(MP3_EXTENSIONS);
    exts.extend(AAC_EXTENSIONS);
    exts
}

fn has_extension(path: &Path, extensions: &[&str]) -> bool {
    path.extension()
        .and_then(|ext| ext.to_str())
        .map(|ext| extensions.iter().any(|e| ext.eq_ignore_ascii_case(e)))
        .unwrap_or(false)
}

pub fn is_mp3(path: &Path) -> bool {
    has_extension(path, MP3_EXTENSIONS)
}

pub fn is_aac(path: &Path) -> bool {
    has_extension(path, AAC_EXTENSIONS)
}