feat: introduce interactive update prompt and enhance audio analysis visualization

Author: LargeModGames

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.30.0] - 2025-12-07
+
+### Added
+
+- **Unskippable Update Prompt**: When a new version is available, users are shown a mandatory modal that must be acknowledged before using the app
+  - Displays current and latest version with update instructions
+  - Press Enter, Esc, q, or Space to dismiss
+  - Replaces the old auto-dismissing notification banner
+
+### Changed
+
+- **Audio Visualization Improvements**:
+  - Added noise gate to filter out background noise when no audio is playing
+  - Boosted high frequency bands (Air, Ultra) for better visibility
+  - Added gradient colors to spectrum bars based on bar height (green → yellow → orange → red)
+
 ## [0.29.0] - 2025-12-07
 
 ### Added

Cargo.lock

@@ -6,7 +6,7 @@ documentation = "https://github.com/LargeModGames/spotatui"
 repository = "https://github.com/LargeModGames/spotatui"
 keywords = ["spotify", "tui", "cli", "terminal"]
 categories = ["command-line-utilities"]
-version = "0.29.3"
+version = "0.30.0"
 authors = ["LargeModGames <LargeModGames@gmail.com>"]
 edition = "2021"
 license = "MIT"

Cargo.toml

@@ -139,6 +139,7 @@ pub enum ActiveBlock {
   Artists,
   BasicView,
   Dialog(DialogContext),
+  UpdatePrompt,
 }
 
 #[derive(Clone, PartialEq, Debug)]
@@ -160,6 +161,7 @@ pub enum RouteId {
   PodcastEpisodes,
   Recommendations,
   Dialog,
+  UpdatePrompt,
 }
 
 #[derive(Debug)]
@@ -336,7 +338,7 @@ pub struct App {
   pub dialog: Option<String>,
   pub confirm: bool,
   pub update_available: Option<UpdateInfo>,
-  pub update_notification_shown_at: Option<Instant>,
+  pub update_prompt_acknowledged: bool,
 }
 
 impl Default for App {
@@ -427,7 +429,7 @@ impl Default for App {
       dialog: None,
       confirm: false,
       update_available: None,
-      update_notification_shown_at: None,
+      update_prompt_acknowledged: false,
     }
   }
 }

src/app.rs

@@ -127,21 +127,20 @@ impl AudioAnalyzer {
       }
     }
 
-    // Per-band gain for a pleasing visual curve
-    // Creates a natural "smile curve" - moderate lows, full mids, moderate highs
+    // Per-band gain for visualization - boosted highs to compensate for low energy
     const BAND_GAINS: [f32; NUM_BANDS] = [
-      0.5,  // Sub   - reduce sub rumble
-      0.65, // Bass  - visible but not overwhelming
-      0.8,  // Low   - building up
-      0.9,  // LMid  - almost full
-      1.0,  // Mid   - peak visibility (voice frequencies)
-      1.0,  // UMid  - peak visibility
-      0.95, // High  - slightly reduce
-      0.85, // HiMid - gentle rolloff
-      0.75, // Pres  - continuing rolloff
-      0.65, // Bril  - less harsh highs
-      0.55, // Air   - subtle
-      0.45, // Ultra - very subtle
+      0.7, // Sub   - reduce sub rumble
+      0.8, // Bass  - visible but not overwhelming
+      0.9, // Low   - building up
+      1.0, // LMid  - full
+      1.0, // Mid   - peak visibility (voice frequencies)
+      1.0, // UMid  - peak visibility
+      1.1, // High  - boost slightly
+      1.2, // HiMd  - boost more
+      1.3, // Pres  - boost more
+      1.4, // Bril  - boost more
+      1.6, // Air   - significant boost
+      2.0, // Ultra - major boost (very little energy here)
     ];
 
     // Normalize and apply pleasing visual curve
@@ -160,11 +159,18 @@ impl AudioAnalyzer {
     for i in 0..NUM_BANDS {
       self.spectrum.bands[i] =
         self.spectrum.bands[i] * SMOOTHING + new_bands[i] * (1.0 - SMOOTHING);
+      // Noise gate: treat very low values as zero
+      if self.spectrum.bands[i] < 0.005 {
+        self.spectrum.bands[i] = 0.0;
+      }
     }
 
-    // Update peak with smoothing
+    // Update peak with smoothing and noise gate
     let current_peak = new_bands.iter().cloned().fold(0.0f32, f32::max);
     self.spectrum.peak = self.spectrum.peak * SMOOTHING + current_peak * (1.0 - SMOOTHING);
+    if self.spectrum.peak < 0.005 {
+      self.spectrum.peak = 0.0;
+    }
   }
 }
 

src/audio/analyzer.rs

@@ -11,6 +11,13 @@ pub struct UpdateInfo {
 /// Check for updates in the background (non-blocking)
 /// Returns Some(UpdateInfo) if an update is available, None if up to date
 pub fn check_for_update_silent() -> Option<UpdateInfo> {
+  // ============ TESTING: Uncomment below to simulate update ============
+  // return Some(UpdateInfo {
+  //   current_version: env!("CARGO_PKG_VERSION").to_string(),
+  //   latest_version: "99.0.0".to_string(),
+  // });
+  // =====================================================================
+
   let current_version = cargo_crate_version!();
 
   let status = self_update::backends::github::Update::configure()

src/cli/update.rs

@@ -135,6 +135,7 @@ pub fn handle_right_event(app: &mut App) {
       RouteId::Analysis => {}
       RouteId::BasicView => {}
       RouteId::Dialog => {}
+      RouteId::UpdatePrompt => {}
     },
     _ => {}
   };

src/handlers/common_key_events.rs

@@ -21,6 +21,7 @@ mod recently_played;
 mod search_results;
 mod select_device;
 mod track_table;
+mod update_prompt;
 
 use super::app::{ActiveBlock, App, ArtistBlock, RouteId, SearchResultBlock};
 use crate::event::Key;
@@ -170,6 +171,9 @@ fn handle_block_events(key: Key, app: &mut App) {
     ActiveBlock::Dialog(_) => {
       dialog::handler(key, app);
     }
+    ActiveBlock::UpdatePrompt => {
+      update_prompt::handler(key, app);
+    }
   }
 }
 
@@ -191,6 +195,8 @@ fn handle_escape(app: &mut App) {
     }
     // These are global views that have no active/inactive distinction so do nothing
     ActiveBlock::SelectDevice | ActiveBlock::Analysis => {}
+    // Update prompt must be dismissed with Enter/Esc, not global escape
+    ActiveBlock::UpdatePrompt => {}
     _ => {
       app.set_current_route_state(Some(ActiveBlock::Empty), None);
     }

src/handlers/mod.rs

@@ -0,0 +1,12 @@
+use super::super::app::App;
+use crate::event::Key;
+
+pub fn handler(key: Key, app: &mut App) {
+  match key {
+    Key::Enter | Key::Esc | Key::Char('q') | Key::Char(' ') => {
+      app.update_prompt_acknowledged = true;
+      app.pop_navigation_stack();
+    }
+    _ => {}
+  }
+}

src/handlers/update_prompt.rs

@@ -467,21 +467,20 @@ async fn start_ui(user_config: UserConfig, app: &Arc<Mutex<App>>) -> Result<()>
   #[cfg(any(feature = "audio-viz", feature = "audio-viz-cpal"))]
   let mut audio_capture: Option<audio::AudioCaptureManager> = None;
 
-  // Check for updates in background (non-blocking)
-  let app_clone = Arc::clone(app);
-  tokio::spawn(async move {
-    // Run update check in a blocking thread pool since self_update uses blocking I/O
+  // Check for updates SYNCHRONOUSLY before starting the event loop
+  // This ensures the update prompt appears before any user interaction
+  {
     let update_info = tokio::task::spawn_blocking(cli::check_for_update_silent)
       .await
       .ok()
       .flatten();
     if let Some(info) = update_info {
-      if let Ok(mut app) = app_clone.try_lock() {
-        app.update_available = Some(info);
-        app.update_notification_shown_at = Some(std::time::Instant::now());
-      }
+      let mut app = app.lock().await;
+      app.update_available = Some(info);
+      // Push the mandatory update prompt modal onto navigation stack
+      app.push_navigation_stack(RouteId::UpdatePrompt, ActiveBlock::UpdatePrompt);
     }
-  });
+  }
 
   // play music on, if not send them to the device selection view
 
@@ -537,6 +536,9 @@ async fn start_ui(user_config: UserConfig, app: &Arc<Mutex<App>>) -> Result<()>
       ActiveBlock::BasicView => {
         ui::draw_basic_view(f, &app);
       }
+      ActiveBlock::UpdatePrompt => {
+        ui::draw_update_prompt(f, &app);
+      }
       _ => {
         ui::draw_main_layout(f, &app);
       }