feat: autoplay

Author: Harshal6927

src/audio_manager.py

@@ -1,6 +1,7 @@
 # Copyright (c) 2025. All rights reserved.
 """Audio device management and playback functionality."""
 
+import time
 from pathlib import Path
 
 import numpy as np
@@ -167,7 +168,9 @@ def play_audio(self, audio_file: Path, *, blocking: bool = False) -> bool:
             sd.play(data, samplerate, device=self.output_device_id)
 
             if blocking:
-                sd.wait()
+                # Use polling loop instead of sd.wait() to allow KeyboardInterrupt
+                while sd.get_stream() and sd.get_stream().active:
+                    time.sleep(0.1)
         except (OSError, RuntimeError) as e:
             self.console.print(f"[red]Error:[/red] {e}")
             return False

src/cli.py

@@ -1,6 +1,7 @@
 # Copyright (c) 2025. All rights reserved.
 """CLI interface using rich-click for beautiful output."""
 
+import contextlib
 import sys
 
 import rich_click as click
@@ -225,6 +226,25 @@ def volume(level: float | None) -> None:
         console.print("[green]✓[/green] Volume saved!")
 
 
+@cli.command()
+@click.option("--sequential", is_flag=True, help="Play sounds in alphabetical order instead of random.")
+def auto(sequential: bool) -> None:  # noqa: FBT001
+    """Play all sounds randomly, one after another.
+
+    Each sound will play completely before the next one starts.
+    Press Ctrl+C to stop playback.
+    """
+    soundboard, _ = get_soundboard()
+
+    if not soundboard.sounds:
+        console.print("[red]✗[/red] No sounds found.")
+        console.print(f"[dim]Add audio files to: {soundboard.sounds_dir}[/dim]")
+        sys.exit(1)
+
+    with contextlib.suppress(KeyboardInterrupt):
+        soundboard.play_all_sounds(shuffle=not sequential)
+
+
 def _handle_play_sound(soundboard: Soundboard) -> None:
     """Handle playing a sound by name."""
     sound_name = click.prompt("Enter sound name")
@@ -284,11 +304,18 @@ def _show_menu() -> None:
     console.print("6. List audio devices")
     console.print("7. Change output device")
     console.print("8. Adjust volume")
+    console.print("9. Auto-play all sounds")
     console.print("0. Exit")
 
 
+def _handle_auto_play(soundboard: Soundboard) -> None:
+    """Handle auto-play all sounds."""
+    with contextlib.suppress(KeyboardInterrupt):
+        soundboard.play_all_sounds()
+
+
 @cli.command()
-def interactive() -> None:  # noqa: C901
+def interactive() -> None:
     """Launch interactive menu mode.
 
     Provides a text-based menu for exploring and using the soundboard.
@@ -302,29 +329,30 @@ def interactive() -> None:  # noqa: C901
 
     soundboard.setup_default_hotkeys()
 
+    # Menu action dispatch table (lambdas needed for partial application)
+    menu_actions = {
+        "1": soundboard.list_sounds,
+        "2": lambda: _handle_play_sound(soundboard),
+        "3": soundboard.list_hotkeys,
+        "4": lambda: _handle_hotkey_listener(soundboard),
+        "5": soundboard.stop_sound,
+        "6": audio_manager.print_devices,
+        "7": lambda: _handle_change_device(audio_manager),
+        "8": lambda: _handle_volume(audio_manager),
+        "9": lambda: _handle_auto_play(soundboard),
+    }
+
     while True:
         _show_menu()
         choice = click.prompt("\nEnter your choice", type=str).strip()
 
-        if choice == "1":
-            soundboard.list_sounds()
-        elif choice == "2":
-            _handle_play_sound(soundboard)
-        elif choice == "3":
-            soundboard.list_hotkeys()
-        elif choice == "4":
-            _handle_hotkey_listener(soundboard)
-        elif choice == "5":
-            soundboard.stop_sound()
-        elif choice == "6":
-            audio_manager.print_devices()
-        elif choice == "7":
-            _handle_change_device(audio_manager)
-        elif choice == "8":
-            _handle_volume(audio_manager)
-        elif choice == "0":
+        if choice == "0":
             console.print("\n[cyan]Goodbye! 👋[/cyan]")
             break
+
+        action = menu_actions.get(choice)
+        if action:
+            action()
         else:
             console.print("[red]Invalid choice.[/red]")
 

src/soundboard.py

@@ -1,6 +1,7 @@
 # Copyright (c) 2025. All rights reserved.
 """Soundboard with hotkey bindings for playing audio files."""
 
+import random
 from pathlib import Path
 
 from pynput import keyboard
@@ -140,22 +141,58 @@ def stop_listening(self) -> None:
             self.listener.stop()
             self.listener = None
 
-    def play_sound(self, sound_name: str) -> bool:
+    def play_sound(self, sound_name: str, *, blocking: bool = False) -> bool:
         """Manually play a sound by name.
 
         Args:
             sound_name: Name of the sound to play
+            blocking: If True, wait for playback to finish
 
         Returns:
             True if playback started successfully
 
         """
         audio_file = self.sounds.get(sound_name)
         if audio_file:
-            return self.audio_manager.play_audio(audio_file)
+            return self.audio_manager.play_audio(audio_file, blocking=blocking)
         self.console.print(f"[red]✗[/red] Sound '{sound_name}' not found.")
         return False
 
+    def play_all_sounds(self, *, shuffle: bool = True) -> None:
+        """Play all sounds in random or sequential order.
+
+        Args:
+            shuffle: If True, play sounds in random order. Default is True.
+
+        Raises:
+            KeyboardInterrupt: When user presses Ctrl+C to stop playback.
+
+        """
+        if not self.sounds:
+            self.console.print("[yellow]⚠[/yellow] No sounds to play.")
+            return
+
+        sound_names = list(self.sounds.keys())
+        if shuffle:
+            random.shuffle(sound_names)
+        else:
+            sound_names = sorted(sound_names)
+
+        total = len(sound_names)
+        mode = "randomly" if shuffle else "sequentially"
+
+        self.console.print(f"\n[bold cyan]Playing {total} sounds {mode}...[/bold cyan]")
+        self.console.print("[dim]Press Ctrl+C to stop[/dim]\n")
+
+        try:
+            for idx, sound_name in enumerate(sound_names, 1):
+                self.console.print(f"[cyan][{idx}/{total}][/cyan] ", end="")
+                self.play_sound(sound_name, blocking=True)
+        except KeyboardInterrupt:
+            self.console.print("\n[yellow]⏸[/yellow] Playback interrupted.")
+            self.stop_sound()
+            raise
+
     def list_sounds(self) -> None:
         """Print all available sounds in a formatted table."""
         if not self.sounds: