Make audio-visualizations an optional feature

Author: zachfeldman

Cargo.lock

@@ -12,4 +12,7 @@ image = "0.24.5"
 rand = "0.8.5"
 chrono = "0.4.23"
 
-vis-core = { git = "https://github.com/Rahix/visualizer2.git", rev = '1fe908012a9c156695921f3b6bb47178e1332b92' }
+# For audio visualizations
+vis-core = {git = 'https://github.com/Rahix/visualizer2.git', rev = '1fe908012a9c156695921f3b6bb47178e1332b92', optional = true}
+[features]
+audio-visualizations = ["vis-core"]

inputmodule-control/Cargo.toml

@@ -242,6 +242,7 @@ pub fn serial_commands(args: &crate::ClapCli) {
                 random_eq_cmd(&serialdevs);
             }
 
+            #[cfg(feature = "audio-visualizations")]
             if ledmatrix_args.input_eq {
                 input_eq_cmd(&serialdevs);
             }
@@ -640,6 +641,7 @@ fn random_eq_cmd(serialdevs: &Vec<String>) {
     }
 }
 
+#[cfg(feature = "audio-visualizations")]
 /// The data-type for storing analyzer results
 #[derive(Debug, Clone)]
 pub struct AnalyzerResult {
@@ -648,6 +650,7 @@ pub struct AnalyzerResult {
     beat: f32,
 }
 
+#[cfg(feature = "audio-visualizations")]
 // Equalizer-like animation that expands as volume goes up and retracts as it goes down
 fn input_eq_cmd(serialdevs: &Vec<String>) {
     // Example from https://github.com/Rahix/visualizer2/blob/canon/README.md

inputmodule-control/src/inputmodule.rs

@@ -117,6 +117,18 @@ inputmodule-control led-matrix --random-eq
 inputmodule-control led-matrix --eq 1 2 3 4 5 4 3 2 1
 ```
 
+###### Input equalizer
+
+This command generates an equalizer-like visualization of the current audio input. It has only been tested on Linux-based systems running `alsa` or equivalent.
+
+You must compile the `inputmodule-control` binary with the `audio-visualization` feature on:
+`cargo clean && cargo build --features audio-visualizations --target x86_64-unknown-linux-gnu -p inputmodule-control`
+
+Once compiled, you can use the `--input-eq` arg to try the visualizer:
+```sh
+inputmodule-control led-matrix --input-eq
+```
+
 ###### Custom string
 
 Display a custom string of up to 5 characters.