@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/spotify.md

@@ -0,0 +1,901 @@
+# Installing Spotify
+
+## Dependencies
+
+### macOS (Homebrew)
+- **Required:**
+  - `brew` (Homebrew package manager) - Install via `dev install homebrew` or visit https://brew.sh
+- **Optional:** None
+- **Auto-installed:** None
+
+### Ubuntu/Debian (APT/Snap)
+- **Required:**
+  - `snapd` (Snap package manager) - Install via `sudo apt-get update && sudo apt-get install -y snapd && sudo systemctl enable --now snapd.socket`
+- **Optional:** None
+- **Auto-installed:** None
+
+### Raspberry Pi OS (APT/Snap)
+- **Required:**
+  - `curl` - Install via `sudo apt-get update && sudo apt-get install -y curl`
+  - APT package manager (pre-installed on Raspberry Pi OS)
+  - Spotify Premium account (required for Raspotify/Spotify Connect functionality)
+- **Optional:** None
+- **Auto-installed:**
+  - Raspotify service and all its dependencies (installed by https://dtcooper.github.io/raspotify/install.sh)
+
+### Amazon Linux/RHEL (DNF/YUM)
+- **Required:**
+  - `dnf` or `yum` package manager (pre-installed on Amazon Linux/RHEL)
+  - EPEL repository - Install via `sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm` (AL2023/RHEL9) or `sudo amazon-linux-extras install -y epel` (AL2)
+  - `snapd` - Install via `sudo dnf install -y snapd` or `sudo yum install -y snapd`
+  - Graphical desktop environment (GNOME, KDE, etc.) for GUI functionality
+- **Optional:** None
+- **Auto-installed:**
+  - Classic snap support symlink (`/snap` -> `/var/lib/snapd/snap`)
+
+### Windows (Chocolatey/winget)
+- **Required:**
+  - `choco` (Chocolatey package manager) - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
+  - Administrator privileges (required for installation)
+- **Optional:** None
+- **Auto-installed:** None
+
+### Git Bash (Manual/Portable)
+- **Required:**
+  - `choco` (Chocolatey on Windows host) - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
+  - PowerShell access (for invoking Windows package manager)
+  - Administrator privileges (required for installation on Windows host)
+- **Optional:** None
+- **Auto-installed:** None (Spotify is installed on Windows host and accessed from Git Bash)
+
+## Overview
+
+Spotify is a digital music streaming service that provides access to millions of songs, podcasts, and videos from creators worldwide. The desktop application offers features including offline listening (with Premium), high-quality audio streaming, curated playlists, and seamless syncing across devices. Spotify is widely used for personal entertainment, background music during development, and podcast consumption.
+
+**Important Platform Note**: Spotify for Linux is described by Spotify as "a labor of love from our engineers that wanted to listen to Spotify on their Linux development machines. They work on it in their spare time and it is currently not a platform that we actively support." The experience may differ from Windows and Mac clients.
+
+## Prerequisites
+
+Before installing Spotify on any platform, ensure:
+
+1. **Internet connectivity** - Required to download Spotify and stream music
+2. **Spotify account** - Required to sign in (create a free account at spotify.com or upgrade to Premium for additional features)
+3. **Audio output** - Speakers or headphones connected to your system
+4. **64-bit operating system** - Required for native desktop applications on most platforms
+
+## Platform-Specific Installation
+
+### macOS (Homebrew)
+
+#### Prerequisites
+
+- macOS 12 (Monterey) or later
+- Homebrew package manager installed
+- At least 500 MB free disk space
+- Apple Silicon (M1/M2/M3/M4) or Intel processor
+
+If Homebrew is not installed, install it first:
+
+```bash
+NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+#### Installation Steps
+
+Run the following command to install Spotify:
+
+```bash
+brew install --quiet --cask spotify
+```
+
+The `--quiet` flag suppresses non-essential output for automation-friendly installation. The `--cask` flag specifies the graphical application version.
+
+After installation, launch Spotify from the Applications folder or via command line:
+
+```bash
+open -a Spotify
+```
+
+**Note**: On first launch, Spotify will prompt you to sign in with your account credentials.
+
+#### Verification
+
+Confirm the installation succeeded by checking if the application exists:
+
+```bash
+ls /Applications/ | grep -i spotify
+```
+
+Expected output:
+
+```
+Spotify.app
+```
+
+Verify Spotify can launch:
+
+```bash
+open -a Spotify
+```
+
+#### Troubleshooting
+
+**Problem**: `Error: Cask 'spotify' requires macOS >= 12`
+
+**Solution**: Your macOS version is too old. Spotify requires macOS 12 (Monterey) or later. Upgrade your operating system before installing.
+
+**Problem**: "Spotify is damaged and can't be opened" error
+
+**Solution**: Clear the quarantine attribute:
+
+```bash
+xattr -cr "/Applications/Spotify.app"
+```
+
+**Problem**: Cask already installed
+
+**Solution**: If you need to reinstall, first uninstall then reinstall:
+
+```bash
+brew uninstall --cask spotify
+brew install --quiet --cask spotify
+```
+
+**Problem**: Spotify fails to start after macOS upgrade
+
+**Solution**: Reinstall Spotify:
+
+```bash
+brew uninstall --cask spotify
+brew install --quiet --cask spotify
+```
+
+---
+
+### Ubuntu/Debian (Snap)
+
+#### Prerequisites
+
+- Ubuntu 16.04 LTS or later, or Debian 10 (Buster) or later (64-bit x86_64)
+- sudo privileges
+- Snap package manager (pre-installed on Ubuntu 16.04+)
+- At least 250 MB free disk space
+
+Snap is pre-installed on Ubuntu 16.04 and later. If snap is not installed (common on Debian):
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+sudo systemctl enable --now snapd.socket
+sudo ln -sf /var/lib/snapd/snap /snap
+```
+
+After installing snapd on Debian, log out and log back in (or reboot) for the snap command to become available in your PATH.
+
+#### Installation Steps
+
+Run the following command to install Spotify via Snap:
+
+```bash
+sudo snap install spotify
+```
+
+The Snap package is the officially supported distribution method by Spotify for Linux.
+
+After installation, launch Spotify:
+
+```bash
+spotify &
+```
+
+The ampersand (`&`) runs Spotify in the background, freeing your terminal.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+snap list spotify
+```
+
+Expected output (version may vary):
+
+```
+Name     Version         Rev    Tracking       Publisher   Notes
+spotify  1.2.74.477...   168    latest/stable  spotify     -
+```
+
+Verify Spotify launches correctly:
+
+```bash
+spotify &
+```
+
+The Spotify window should appear within a few seconds.
+
+#### Troubleshooting
+
+**Problem**: `error: snap "spotify" is not available on stable for this architecture`
+
+**Solution**: This error occurs on 32-bit systems or ARM architecture. Spotify's Snap package requires 64-bit x86_64 (amd64) architecture. Check your architecture:
+
+```bash
+uname -m
+```
+
+If output is anything other than `x86_64`, you cannot install the native Spotify client. Use the web player at https://open.spotify.com instead.
+
+**Problem**: "cannot communicate with server: Post ... dial unix /run/snapd.socket"
+
+**Solution**: The snap daemon is not running. Start it:
+
+```bash
+sudo systemctl start snapd
+sudo systemctl enable snapd
+```
+
+**Problem**: Spotify fails to launch with GPU/rendering errors
+
+**Solution**: Disable GPU acceleration by launching with:
+
+```bash
+spotify --disable-gpu &
+```
+
+**Problem**: Notifications not appearing
+
+**Solution**: Ensure notification permissions are granted in your desktop environment settings. On GNOME, check Settings > Notifications > Spotify.
+
+**Problem**: Audio playback issues
+
+**Solution**: Ensure PulseAudio or PipeWire is running:
+
+```bash
+pulseaudio --check || pulseaudio --start
+```
+
+---
+
+### Raspberry Pi OS (ARM)
+
+#### Platform Limitation
+
+**Spotify does not provide native ARM packages.** The official Spotify desktop application and Snap package are only available for x86_64 (amd64) architecture. Raspberry Pi devices use ARM processors, which are not supported by the official client.
+
+#### Prerequisites
+
+- Raspberry Pi OS (64-bit or 32-bit)
+- Raspberry Pi 3 or later (Raspberry Pi 4 or 5 recommended)
+- sudo privileges
+- Spotify Premium account (required for Raspotify/Spotify Connect)
+
+#### Installation Steps
+
+**Use Raspotify for Spotify Connect**
+
+Raspotify is an open-source Spotify Connect client that turns your Raspberry Pi into a Spotify speaker. You control playback from your phone, tablet, or computer, and audio plays through the Raspberry Pi.
+
+**Note**: Raspotify requires a Spotify Premium account.
+
+```bash
+# Install curl if not present
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y curl
+
+# Install Raspotify
+curl -sL https://dtcooper.github.io/raspotify/install.sh | sh
+```
+
+After installation, Raspotify runs as a service and starts automatically on boot.
+
+**Configure Raspotify (Optional)**
+
+Edit the configuration file to customize device name and other settings:
+
+```bash
+sudo nano /etc/raspotify/conf
+```
+
+Key configuration options:
+
+```bash
+# Device name that appears in Spotify Connect
+LIBRESPOT_NAME="Raspberry Pi"
+
+# Audio backend (use 'alsa' for direct ALSA output)
+LIBRESPOT_BACKEND="alsa"
+
+# Audio device (use 'aplay -l' to list devices)
+LIBRESPOT_DEVICE="default"
+
+# Bitrate: 96, 160, or 320 (Premium only)
+LIBRESPOT_BITRATE="320"
+```
+
+Restart the service after making changes:
+
+```bash
+sudo systemctl restart raspotify
+```
+
+#### Verification
+
+Confirm Raspotify is running:
+
+```bash
+sudo systemctl status raspotify
+```
+
+Expected output should show "active (running)".
+
+Test Spotify Connect:
+
+1. Open Spotify on your phone, tablet, or computer
+2. Start playing music
+3. Tap the "Connect to a device" icon (speaker icon)
+4. Select your Raspberry Pi from the device list
+5. Audio should play through the Raspberry Pi speakers
+
+#### Troubleshooting
+
+**Problem**: Raspotify service fails to start
+
+**Solution**: Check the service logs:
+
+```bash
+sudo journalctl -u raspotify -n 50
+```
+
+Common issues include audio device misconfiguration. List available audio devices:
+
+```bash
+aplay -l
+```
+
+**Problem**: Device does not appear in Spotify Connect
+
+**Solution**: Ensure your Raspberry Pi and control device are on the same network. Restart the service:
+
+```bash
+sudo systemctl restart raspotify
+```
+
+**Problem**: Audio quality is poor or distorted
+
+**Solution**: Reduce the bitrate in `/etc/raspotify/conf`:
+
+```bash
+LIBRESPOT_BITRATE="160"
+```
+
+Then restart the service.
+
+**Problem**: "Cannot connect to Spotify" errors
+
+**Solution**: Raspotify requires a Premium account. Verify your subscription at https://www.spotify.com/account.
+
+---
+
+### Amazon Linux/RHEL (Snap)
+
+#### Prerequisites
+
+- Amazon Linux 2023, Amazon Linux 2, RHEL 8/9, or Fedora (64-bit x86_64)
+- sudo privileges
+- Graphical desktop environment (required for Spotify GUI)
+- EPEL repository enabled (for RHEL/Amazon Linux)
+- At least 250 MB free disk space
+
+**Important**: Amazon Linux EC2 instances typically run headless (no GUI). If you are running a headless server, use the Spotify web player at https://open.spotify.com instead.
+
+#### Installation Steps
+
+**Step 1: Enable EPEL and install snapd**
+
+For Amazon Linux 2023:
+
+```bash
+sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
+sudo dnf install -y snapd
+```
+
+For Amazon Linux 2:
+
+```bash
+sudo amazon-linux-extras install -y epel
+sudo yum install -y snapd
+```
+
+For RHEL 8/9:
+
+```bash
+sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm
+sudo dnf install -y snapd
+```
+
+**Step 2: Enable and start snapd**
+
+```bash
+sudo systemctl enable --now snapd.socket
+sudo ln -sf /var/lib/snapd/snap /snap
+```
+
+**Important**: Log out and log back in (or reboot) after this step for the snap command to become available in your PATH.
+
+**Step 3: Install Spotify**
+
+```bash
+sudo snap install spotify
+```
+
+After installation, launch Spotify:
+
+```bash
+spotify &
+```
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+snap list spotify
+```
+
+Expected output (version may vary):
+
+```
+Name     Version         Rev    Tracking       Publisher   Notes
+spotify  1.2.74.477...   168    latest/stable  spotify     -
+```
+
+Verify Spotify can launch (requires graphical environment):
+
+```bash
+spotify &
+```
+
+#### Troubleshooting
+
+**Problem**: `error: snap "spotify" is not available on stable for this architecture`
+
+**Solution**: Spotify requires x86_64 architecture. Check your architecture:
+
+```bash
+uname -m
+```
+
+If not `x86_64`, use the web player at https://open.spotify.com.
+
+**Problem**: Snapd fails to install
+
+**Solution**: Ensure EPEL repository is enabled:
+
+```bash
+# RHEL 8/9
+sudo dnf repolist | grep epel
+
+# If not listed, install EPEL
+sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm
+```
+
+**Problem**: Spotify fails to launch with display errors
+
+**Solution**: Spotify requires a graphical environment. For headless servers:
+- Use X11 forwarding with SSH: `ssh -X user@server` then run `spotify`
+- Use VNC or RDP to connect to a desktop session
+- Use the Spotify web player at https://open.spotify.com
+
+**Problem**: Audio playback issues
+
+**Solution**: Ensure PulseAudio is installed and running:
+
+```bash
+sudo dnf install -y pulseaudio pulseaudio-utils
+pulseaudio --start
+```
+
+---
+
+### Windows (Chocolatey)
+
+#### Prerequisites
+
+- Windows 10 version 1903 or later, or Windows 11 (64-bit)
+- At least 500 MB free disk space
+- Administrator PowerShell or Command Prompt
+- Chocolatey package manager installed
+
+If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
+```
+
+#### Installation Steps
+
+Run the following command in an Administrator PowerShell or Command Prompt:
+
+```powershell
+choco install spotify -y
+```
+
+The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation.
+
+After installation, Spotify can be launched from the Start Menu or via command line:
+
+```powershell
+Start-Process spotify:
+```
+
+**Note**: On first launch, Spotify will prompt you to sign in with your account credentials.
+
+#### Verification
+
+Open a new Command Prompt or PowerShell window, then verify Spotify is installed:
+
+```powershell
+choco list spotify
+```
+
+Expected output (version may vary):
+
+```
+spotify 1.2.79.427
+1 packages installed.
+```
+
+Launch Spotify to verify it opens correctly:
+
+```powershell
+Start-Process spotify:
+```
+
+The application should launch and display the sign-in screen.
+
+#### Troubleshooting
+
+**Problem**: `choco: command not found` or `'choco' is not recognized`
+
+**Solution**: Chocolatey is not installed or not in PATH. Install Chocolatey first (see Prerequisites), then open a new terminal window.
+
+**Problem**: Installation fails with permission errors
+
+**Solution**: Run PowerShell as Administrator. Right-click PowerShell in the Start Menu and select "Run as administrator".
+
+**Problem**: Spotify fails to launch after installation
+
+**Solution**: Restart your computer to ensure all components are properly registered, then try launching again.
+
+**Problem**: Need to update Spotify
+
+**Solution**: Run the upgrade command:
+
+```powershell
+choco upgrade spotify -y
+```
+
+**Problem**: Installation completes but Spotify does not appear
+
+**Solution**: Spotify installs to the user profile directory. Check:
+
+```powershell
+Get-ChildItem "$env:APPDATA\Spotify" -ErrorAction SilentlyContinue
+```
+
+If the directory exists, launch Spotify from the Start Menu.
+
+---
+
+### WSL (Ubuntu)
+
+#### Platform Approach
+
+**Spotify is installed on the Windows host, not within WSL.** While WSL 2 with WSLg (GUI support) can technically run Linux GUI applications, the recommended approach is to install Spotify on Windows and access it from WSL.
+
+#### Prerequisites
+
+- Windows 10 version 2004 or higher, or Windows 11
+- WSL 2 enabled with Ubuntu distribution installed
+- Administrator access on Windows for Spotify installation
+
+#### Installation Steps
+
+**Step 1: Install Spotify on Windows**
+
+From a Windows Administrator PowerShell:
+
+```powershell
+choco install spotify -y
+```
+
+**Step 2: Access Spotify from WSL**
+
+From within your WSL terminal, you can launch Windows Spotify:
+
+```bash
+# Launch Spotify using Windows protocol handler
+cmd.exe /c start spotify:
+```
+
+This command uses Windows interoperability to launch the Spotify application installed on the Windows host.
+
+**Alternative: Access Spotify via browser from WSL**
+
+If you prefer browser-based access:
+
+```bash
+# Open Spotify web player in default Windows browser
+cmd.exe /c start https://open.spotify.com
+```
+
+#### Verification
+
+From WSL, verify you can launch Windows Spotify:
+
+```bash
+cmd.exe /c start spotify:
+```
+
+Spotify should open in a new window on the Windows desktop.
+
+#### Troubleshooting
+
+**Problem**: Cannot launch Windows Spotify from WSL
+
+**Solution**: Ensure Spotify is installed on Windows first. Run `choco list spotify` in a Windows PowerShell to verify installation.
+
+**Problem**: "start: command not found"
+
+**Solution**: Use the full Windows command syntax:
+
+```bash
+cmd.exe /c start spotify:
+```
+
+**Problem**: Need to use Spotify commands in WSL scripts
+
+**Solution**: Create a helper alias in your `~/.bashrc`:
+
+```bash
+echo 'alias spotify="cmd.exe /c start spotify:"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+Then simply run `spotify` from your WSL terminal.
+
+---
+
+### Git Bash (Windows Installation)
+
+#### Prerequisites
+
+- Windows 10 or Windows 11 (64-bit)
+- Git Bash installed (comes with Git for Windows)
+- Administrator access for Spotify installation
+
+#### Installation Steps
+
+Git Bash runs on Windows, so Spotify is installed on the Windows host and accessible from Git Bash.
+
+**Step 1: Install Spotify on Windows**
+
+From an Administrator Command Prompt or PowerShell (not Git Bash):
+
+```powershell
+choco install spotify -y
+```
+
+**Step 2: Access Spotify from Git Bash**
+
+After installation, Spotify can be launched from Git Bash:
+
+```bash
+start spotify:
+```
+
+Or use the explicit command form:
+
+```bash
+cmd //c "start spotify:"
+```
+
+#### Verification
+
+From Git Bash, verify Spotify can be launched:
+
+```bash
+start spotify:
+```
+
+Spotify should open in a new window.
+
+#### Troubleshooting
+
+**Problem**: `start: command not found`
+
+**Solution**: Use the Windows-style command:
+
+```bash
+cmd //c "start spotify:"
+```
+
+**Problem**: Spotify does not launch
+
+**Solution**: Ensure Spotify is installed on Windows. Open a Windows Command Prompt and verify:
+
+```cmd
+choco list spotify
+```
+
+If not installed, install it from an Administrator PowerShell first.
+
+**Problem**: Need to use Spotify in scripts
+
+**Solution**: For scripting, use the Windows command wrapper:
+
+```bash
+#!/bin/bash
+# Launch Spotify silently
+cmd //c "start /min spotify:" 2>/dev/null
+```
+
+---
+
+## Post-Installation Configuration
+
+After installing Spotify on any platform, complete these configuration steps.
+
+### Signing In
+
+1. Launch Spotify
+2. Click "Log in" and enter your credentials, or sign in with Facebook, Apple, or Google
+3. Complete any two-factor authentication if enabled on your account
+
+### Configuring Audio Quality
+
+Adjust streaming quality based on your internet connection and preferences:
+
+1. Click your profile picture or username
+2. Go to **Settings**
+3. Under **Audio Quality**, select:
+   - **Automatic** - Adjusts based on connection
+   - **Low** (24 kbit/s) - Minimal data usage
+   - **Normal** (96 kbit/s) - Standard quality
+   - **High** (160 kbit/s) - Better quality
+   - **Very High** (320 kbit/s) - Premium only, best quality
+
+### Enabling Offline Mode (Premium)
+
+Download music for offline listening:
+
+1. Navigate to a playlist, album, or podcast
+2. Toggle the **Download** switch
+3. Downloaded content is available without internet connection
+
+### Configuring Startup Behavior
+
+To control whether Spotify starts automatically:
+
+**Windows:**
+1. Open Spotify Settings
+2. Scroll to **Startup and Window Behavior**
+3. Set "Open Spotify automatically after you log into the computer" to No
+
+**macOS:**
+1. Open Spotify Preferences
+2. Scroll to **Startup and Window Behavior**
+3. Set "Open Spotify automatically after you log into the computer" to No
+
+**Linux:**
+```bash
+# Disable autostart
+rm ~/.config/autostart/spotify.desktop 2>/dev/null || true
+```
+
+### Keyboard Shortcuts
+
+Essential shortcuts for productivity:
+
+| Action | Windows/Linux | macOS |
+|--------|---------------|-------|
+| Play/Pause | `Space` | `Space` |
+| Next Track | `Ctrl+Right` | `Cmd+Right` |
+| Previous Track | `Ctrl+Left` | `Cmd+Left` |
+| Volume Up | `Ctrl+Up` | `Cmd+Up` |
+| Volume Down | `Ctrl+Down` | `Cmd+Down` |
+| Search | `Ctrl+L` | `Cmd+L` |
+| Toggle Shuffle | `Ctrl+S` | `Cmd+S` |
+
+---
+
+## Common Issues
+
+### Issue: "Unable to Connect" or Network Errors
+
+**Symptoms**: Spotify shows connection errors or fails to load content
+
+**Solutions**:
+- Check internet connectivity
+- Verify firewall allows Spotify traffic (ports 443, 4070)
+- If behind a corporate proxy, configure proxy settings in Spotify Settings > Advanced > Proxy
+- Try signing out and signing back in
+- Clear cache: Settings > Storage > Clear cache
+
+### Issue: High Memory or CPU Usage
+
+**Symptoms**: Spotify consumes excessive system resources
+
+**Solutions**:
+- Disable hardware acceleration: Settings > Compatibility > Hardware Acceleration (off)
+- Clear cache to free disk space
+- Restart Spotify periodically during long sessions
+- Ensure Spotify is updated to the latest version
+
+### Issue: Audio Playback Problems
+
+**Symptoms**: No sound, stuttering, or distorted audio
+
+**Solutions**:
+
+**All Platforms:**
+- Check system volume and ensure Spotify is not muted
+- Verify correct audio output device is selected in Spotify Settings > Audio
+- Restart Spotify
+
+**Linux:**
+- Ensure PulseAudio or PipeWire is running
+- Check audio device permissions
+
+**Windows:**
+- Run Windows Audio Troubleshooter
+- Update audio drivers
+
+### Issue: Songs Skip or Won't Play
+
+**Symptoms**: Songs skip after a few seconds or show as unavailable
+
+**Solutions**:
+- Check if the song is available in your region
+- Verify your subscription status (some content requires Premium)
+- Clear cache and restart Spotify
+- Check for Spotify service outages at https://downdetector.com/status/spotify/
+
+### Issue: Spotify Connect Not Working
+
+**Symptoms**: Cannot see or connect to other devices
+
+**Solutions**:
+- Ensure all devices are on the same Wi-Fi network
+- Sign out and sign back in on all devices
+- Restart the Spotify app on all devices
+- Check that "Device Broadcast Status" is enabled in Settings
+
+---
+
+## Summary Table
+
+| Platform | Native Support | Installation Method | Notes |
+|----------|---------------|---------------------|-------|
+| macOS | Yes | `brew install --quiet --cask spotify` | Requires macOS 12+ |
+| Windows | Yes | `choco install spotify -y` | Primary supported platform |
+| Ubuntu/Debian | Yes | `sudo snap install spotify` | x86_64 only, not officially supported |
+| Raspberry Pi | No | Raspotify (Spotify Connect) | Requires Premium account |
+| Amazon Linux/RHEL | Yes | Snap via EPEL | x86_64 only, requires desktop |
+| WSL | N/A | Install on Windows host | Uses Windows installation |
+| Git Bash | N/A | Uses Windows installation | Inherits Windows Spotify |
+
+---
+
+## References
+
+- [Spotify Official Website](https://www.spotify.com/)
+- [Spotify Downloads](https://www.spotify.com/download/)
+- [Spotify for Linux](https://www.spotify.com/us/download/linux/)
+- [Spotify Homebrew Cask](https://formulae.brew.sh/cask/spotify)
+- [Spotify Chocolatey Package](https://community.chocolatey.org/packages/spotify)
+- [Spotify Snap Package](https://snapcraft.io/spotify)
+- [Spotify Web Player](https://open.spotify.com)
+- [Raspotify - Spotify Connect for Raspberry Pi](https://github.com/dtcooper/raspotify)
+- [Spotify Community - Linux Support](https://community.spotify.com/t5/Desktop-Linux/bd-p/desktop_linux)
+- [Installing Spotify on Fedora](https://docs.fedoraproject.org/en-US/quick-docs/installing-spotify/)