caesura 0.31.0

An all-in-one command line tool to transcode FLAC audio files and upload to gazelle based indexers/trackers
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

use crate::prelude::*;
use claxon::metadata::StreamInfo;

/// Verify FLAC stream properties are suitable for transcoding.
pub(crate) struct StreamVerifier;

impl StreamVerifier {
    /// Verify stream properties of a FLAC file and return any issues found.
    pub(crate) fn execute(flac: &FlacFile, source: &Source) -> Vec<SourceIssue> {
        let info = match check_flac_readable(flac) {
            Ok(info) => info,
            Err(issue) => return vec![issue],
        };
        let mut issues = Vec::new();
        issues.extend(check_sample_rate(&flac.path, &info));
        issues.extend(check_bit_rate(&flac.path, &info));
        issues.extend(check_duration(&flac.path, &info));
        issues.extend(check_channels(&flac.path, &info));
        if source.torrent.media == Media::CD {
            issues.extend(check_md5(&flac.path, &info));
        }
        issues
    }
}

/// Check the FLAC file can be read and return its stream info.
pub(crate) fn check_flac_readable(flac: &FlacFile) -> Result<StreamInfo, SourceIssue> {
    flac.get_stream_info().map_err(|e| SourceIssue::FlacError {
        path: flac.path.clone(),
        error: format!("{e}"),
    })
}

/// Check the sample rate is a multiple of 44100 or 48000.
pub(crate) fn check_sample_rate(path: &Path, info: &StreamInfo) -> Option<SourceIssue> {
    if get_resample_rate(info).is_err() {
        return Some(SourceIssue::SampleRate {
            path: path.to_path_buf(),
            rate: info.sample_rate,
        });
    }
    None
}

/// Check the average bit rate meets the minimum threshold.
pub(crate) fn check_bit_rate(path: &Path, info: &StreamInfo) -> Option<SourceIssue> {
    if let Some(rate) = get_average_bit_rate(info)
        && rate < MIN_BIT_RATE_KBPS * 1000
    {
        return Some(SourceIssue::BitRate {
            path: path.to_path_buf(),
            rate,
        });
    }
    None
}

/// Check the duration does not exceed the maximum.
pub(crate) fn check_duration(path: &Path, info: &StreamInfo) -> Option<SourceIssue> {
    if let Some(seconds) = get_duration(info)
        && seconds > MAX_DURATION
    {
        return Some(SourceIssue::Duration {
            path: path.to_path_buf(),
            seconds,
        });
    }
    None
}

/// Check the channel count does not exceed 2.
pub(crate) fn check_channels(path: &Path, info: &StreamInfo) -> Option<SourceIssue> {
    if info.channels > 2 {
        return Some(SourceIssue::Channels {
            path: path.to_path_buf(),
            count: info.channels,
        });
    }
    None
}

/// Check the decoded-audio MD5 signature is set.
///
/// An all-zero signature means the encoder never computed it, so the stored
/// stream cannot be checked for integrity.
pub(crate) fn check_md5(path: &Path, info: &StreamInfo) -> Option<SourceIssue> {
    if info.md5sum == [0_u8; 16] {
        return Some(SourceIssue::MissingMd5 {
            path: path.to_path_buf(),
        });
    }
    None
}