From 051a17243cbc3c208ffcfd2b8d89d82d0d71cd7f Mon Sep 17 00:00:00 2001
From: Stu <stu@leaktechnologies.dev>
Date: Wed, 10 Dec 2025 05:55:05 -0500
Subject: [PATCH] Add mpv runtime dependency to installer and build scripts

---
 INSTALLATION.md               | 16 +++++++++++++++-
 scripts/build-linux.sh        |  4 ++++
 scripts/install-deps-linux.sh | 11 +++++++++++
 3 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/INSTALLATION.md b/INSTALLATION.md
index d28034e..6457d90 100644
--- a/INSTALLATION.md
+++ b/INSTALLATION.md
@@ -127,6 +127,7 @@ VideoToolsClean         # Clean build artifacts and cache
 ### Essential
 - **Go 1.21 or later** - https://go.dev/dl/
 - **Bash or Zsh** shell
+- **mpv** (runtime playback backend)
 
 ### Optional
 - **FFmpeg** (for actual video encoding)
@@ -142,6 +143,20 @@ VideoToolsClean         # Clean build artifacts and cache
 ---
 
 ## Troubleshooting
+### "mpv not found"
+
+**Solution:** Install mpv from your package manager:
+
+```bash
+# Debian/Ubuntu
+sudo apt-get install -y mpv
+
+# Fedora/RHEL
+sudo dnf install -y mpv
+
+# Arch
+sudo pacman -S --needed mpv
+```
 
 ### "Go is not installed"
 
@@ -356,4 +371,3 @@ Installation works in WSL environment. Ensure you have WSL with Linux distro ins
 ---
 
 Enjoy using VideoTools! 🎬
-
diff --git a/scripts/build-linux.sh b/scripts/build-linux.sh
index ba61c99..fa0b34a 100755
--- a/scripts/build-linux.sh
+++ b/scripts/build-linux.sh
@@ -42,6 +42,10 @@ fi
 if ! pkg-config --exists gl 2>/dev/null; then
     MISSING_DEPS+=("mesa-libGL-devel")
 fi
+# Runtime dependency: mpv
+if ! command -v mpv >/dev/null 2>&1; then
+    MISSING_DEPS+=("mpv")
+fi
 
 if [ ${#MISSING_DEPS[@]} -gt 0 ]; then
     echo "⚠️  Missing system dependencies: ${MISSING_DEPS[*]}"
diff --git a/scripts/install-deps-linux.sh b/scripts/install-deps-linux.sh
index 0566355..c063bbf 100755
--- a/scripts/install-deps-linux.sh
+++ b/scripts/install-deps-linux.sh
@@ -35,6 +35,7 @@ install_fedora() {
         libXxf86vm-devel \
         mesa-libGL-devel \
         alsa-lib-devel \
+        mpv \
         ffmpeg-free \
         golang
     echo "✓ Fedora dependencies installed"
@@ -55,6 +56,7 @@ install_ubuntu() {
         libxi-dev \
         libxxf86vm-dev \
         libasound2-dev \
+        mpv \
         ffmpeg \
         golang-go
     echo "✓ Ubuntu/Debian dependencies installed"
@@ -74,6 +76,7 @@ install_arch() {
         libxi \
         libxxf86vm \
         alsa-lib \
+        mpv \
         ffmpeg \
         go
     echo "✓ Arch Linux dependencies installed"
@@ -93,6 +96,7 @@ install_opensuse() {
         libXi-devel \
         libXxf86vm-devel \
         alsa-devel \
+        mpv \
         ffmpeg \
         go
     echo "✓ openSUSE dependencies installed"
@@ -158,6 +162,13 @@ else
     echo "⚠️  ffmpeg not found in PATH"
 fi
 
+# Check mpv
+if command -v mpv &> /dev/null; then
+    echo "✓ mpv: $(mpv --version | head -1)"
+else
+    echo "⚠️  mpv not found in PATH"
+fi
+
 # Check pkg-config
 if command -v pkg-config &> /dev/null; then
     echo "✓ pkg-config: $(pkg-config --version)"