v1.1.0: Auto-detect and fix ALSA configuration on startup

- Added get_alsa_card_numbers() to detect speaker and loopback cards
- Added generate_alsa_config() to create proper ALSA configuration
- Added check_and_fix_alsa_config() that runs on app startup
- Automatically fixes ALSA card numbers after reboot
- Updated README with auto-configuration feature

README.md

@@ -29,6 +29,7 @@ Make your Reachy Mini dance to Spotify music! This app analyzes audio in real-ti
 - **Dance Styles** - Energetic, Groovy, Chill, and Hip-Hop modes
 - **Stream Analysis** - Direct audio capture via ALSA loopback (best quality)
 - **Web Control Panel** - Live visualizer with adjustable settings
+- **Auto-Configuration** - Automatically detects and fixes ALSA audio settings
 
 ## Requirements
 
@@ -129,6 +130,7 @@ Spotify App → raspotify → ALSA multi-output
 - **No loopback_in device**: Run `sudo modprobe snd-aloop` and restart the app
 - **Poor detection**: Use loopback_in, increase sensitivity, turn up volume
 - **Tracks skip**: Check ALSA config and IPC permissions (see setup guide)
+- **ALSA errors after reboot**: The app auto-detects and fixes card numbers on startup. If issues persist, see the [setup guide](docs/spotify_setup.md)
 
 ## License
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spotify_dancer"
-version = "1.0.0"
+version = "1.1.0"
 description = "Spotify Dance Mode for Reachy Mini - Robot dances to your music"
 readme = "README.md"
 requires-python = ">=3.10"

spotify_dancer/main.py

@@ -335,6 +335,124 @@ def setup_loopback() -> bool:
         return False
 
 
+def get_alsa_card_numbers() -> tuple:
+    """Auto-detect ALSA card numbers for speaker and loopback."""
+    speaker_card = None
+    loopback_card = None
+    try:
+        result = subprocess.run(['aplay', '-l'], capture_output=True, text=True, timeout=5)
+        if result.returncode == 0:
+            for line in result.stdout.split('\n'):
+                if line.startswith('card '):
+                    parts = line.split(':')
+                    if len(parts) >= 2:
+                        card_num = parts[0].replace('card ', '').strip()
+                        card_info = parts[1].lower()
+                        if 'loopback' in card_info and loopback_card is None:
+                            loopback_card = card_num
+                        elif ('audio' in card_info or 'reachy' in card_info) and speaker_card is None:
+                            speaker_card = card_num
+    except Exception as e:
+        logger.error(f"Failed to detect ALSA cards: {e}")
+    return speaker_card, loopback_card
+
+
+def generate_alsa_config(speaker_card: str, loopback_card: str) -> str:
+    """Generate ALSA configuration."""
+    return f"""# Reachy Mini ALSA Configuration (auto-generated)
+pcm.!default {{ type hw; card {speaker_card} }}
+ctl.!default {{ type hw; card {speaker_card} }}
+
+pcm.reachymini_audio_sink {{
+    type dmix
+    ipc_key 4241
+    ipc_perm 0777
+    ipc_key_add_uid false
+    slave {{ pcm "hw:{speaker_card},0"; channels 2; period_size 1024; buffer_size 4096; rate 16000 }}
+}}
+
+pcm.reachymini_audio_src {{
+    type dsnoop
+    ipc_key 4242
+    ipc_perm 0777
+    ipc_key_add_uid false
+    slave {{ pcm "hw:{speaker_card},0"; channels 2; rate 16000; period_size 1024; buffer_size 4096 }}
+}}
+
+pcm.loopback_out {{ type plug; slave.pcm "hw:{loopback_card},0" }}
+pcm.loopback_in {{ type plug; slave.pcm "hw:{loopback_card},1" }}
+
+pcm.spotify_multi {{
+    type plug
+    slave.pcm {{
+        type multi
+        slaves {{
+            a {{ pcm "reachymini_audio_sink" channels 2 }}
+            b {{ pcm "loopback_out" channels 2 }}
+        }}
+        bindings {{
+            0 {{ slave a channel 0 }}
+            1 {{ slave a channel 1 }}
+            2 {{ slave b channel 0 }}
+            3 {{ slave b channel 1 }}
+        }}
+    }}
+    ttable.0.0 1
+    ttable.1.1 1
+    ttable.0.2 1
+    ttable.1.3 1
+}}
+
+pcm.spotify {{ type plug; slave.pcm "spotify_multi" }}
+"""
+
+
+def check_and_fix_alsa_config():
+    """Check if ALSA config is valid, fix if needed."""
+    # Test if spotify device works
+    try:
+        result = subprocess.run(
+            ['aplay', '-D', 'spotify', '-d', '0', '/dev/zero'],
+            capture_output=True, timeout=3
+        )
+        if result.returncode == 0:
+            logger.info("ALSA config OK")
+            return True
+    except Exception:
+        pass
+
+    # Config doesn't work, try to fix it
+    logger.warning("ALSA config invalid, attempting auto-fix...")
+    speaker_card, loopback_card = get_alsa_card_numbers()
+
+    if speaker_card is None or loopback_card is None:
+        logger.error(f"Could not detect cards: speaker={speaker_card}, loopback={loopback_card}")
+        return False
+
+    logger.info(f"Detected: speaker=card {speaker_card}, loopback=card {loopback_card}")
+
+    config = generate_alsa_config(speaker_card, loopback_card)
+    try:
+        with open('/tmp/asound.conf', 'w') as f:
+            f.write(config)
+        result = subprocess.run(
+            ['sudo', 'cp', '/tmp/asound.conf', '/etc/asound.conf'],
+            capture_output=True, timeout=5
+        )
+        if result.returncode == 0:
+            logger.info("ALSA config updated successfully")
+            # Restart raspotify to use new config
+            subprocess.run(['sudo', 'systemctl', 'restart', 'raspotify'],
+                         capture_output=True, timeout=10)
+            return True
+        else:
+            logger.error(f"Failed to save config: {result.stderr.decode()}")
+    except Exception as e:
+        logger.error(f"Error fixing config: {e}")
+
+    return False
+
+
 # =============================================================================
 # Main App
 # =============================================================================
@@ -358,6 +476,9 @@ class SpotifyDancer(ReachyMiniApp):
 
     def run(self, reachy_mini: ReachyMini, stop_event: threading.Event):
         """Main app loop."""
+        # Auto-fix ALSA config if needed
+        check_and_fix_alsa_config()
+
         # Start UI in background
         ui_thread = threading.Thread(
             target=self._run_ui,