zim-studio 1.5.0

A Terminal-Based Audio Project Scaffold and Metadata System
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

use std::error::Error;

// Maximum playlist size to prevent memory issues
const MAX_PLAYLIST_SIZE: usize = 1000;

pub fn handle_play(
    files: Vec<String>,
    gains: Option<Vec<f32>>,
    interactive: bool,
) -> Result<(), Box<dyn Error>> {
    #[cfg(feature = "player")]
    {
        // Validate inputs
        if files.is_empty() && !interactive {
            use owo_colors::OwoColorize;
            println!(
                "{} No files specified. Use {} flag for browser mode.",
                "Error:".red(),
                "--interactive".cyan()
            );
            return Err("No files specified".into());
        }

        // Check file limit for mixing mode (when gains are specified)
        if gains.is_some() && files.len() > 3 {
            use owo_colors::OwoColorize;
            println!(
                "{} Maximum 3 files supported for mixing mode (with --gains).",
                "Error:".red()
            );
            println!(
                "For playlist mode, specify files without --gains (up to {MAX_PLAYLIST_SIZE} files supported)."
            );
            return Err("Too many files for mixing mode".into());
        }

        // Check playlist size limit to prevent memory issues
        if gains.is_none() && files.len() > MAX_PLAYLIST_SIZE {
            use owo_colors::OwoColorize;
            println!(
                "{} Playlist too large: {} files (maximum {} supported).",
                "Error:".red(),
                files.len(),
                MAX_PLAYLIST_SIZE
            );
            return Err("Playlist exceeds maximum size".into());
        }

        // Validate gains if provided
        if let Some(ref g) = gains {
            if !files.is_empty() && g.len() != files.len() {
                use owo_colors::OwoColorize;
                println!(
                    "{} Number of gains ({}) must match number of files ({}).",
                    "Error:".red(),
                    g.len(),
                    files.len()
                );
                return Err("Gain count mismatch".into());
            }

            for (i, gain) in g.iter().enumerate() {
                if *gain < 0.0 || *gain > 2.0 {
                    use owo_colors::OwoColorize;
                    println!(
                        "{} Gain {} ({}) must be between 0.0 and 2.0.",
                        "Error:".red(),
                        i + 1,
                        gain
                    );
                    return Err("Invalid gain value".into());
                }
            }
        }

        crate::player::run(files, gains, interactive)
    }

    #[cfg(not(feature = "player"))]
    {
        let _ = files;
        let _ = gains;
        let _ = interactive;
        use owo_colors::OwoColorize;
        println!("{} {}", "🎵".cyan(), "Audio Player".bold());
        println!();
        println!(
            "{} The audio player requires the 'player' feature to be enabled.",
            "Note:".yellow()
        );
        println!();
        println!("To enable it, install with:");
        println!("  {}", "cargo install zim-studio --features player".cyan());
        println!();
        println!("Or if building from source:");
        println!("  {}", "cargo build --release --features player".cyan());

        Ok(())
    }
}