api.php

<?php
include_once("/opt/fpp/www/common.php");
$pluginName = "fpp-plugin-BackgroundMusic";
$pluginConfigFile = (isset($settings['configDirectory']) ? $settings['configDirectory'] : '/home/fpp/media/config') . "/plugin." . $pluginName;

function getEndpointsfpppluginBackgroundMusic() {
    $result = array();

    $ep = array(
        'method' => 'GET',
        'endpoint' => 'version',
        'callback' => 'fppBackgroundMusicVersion');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'status',
        'callback' => 'fppBackgroundMusicStatus');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'headerIndicator',
        'callback' => 'fppBackgroundMusicHeaderIndicator');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'start-background',
        'callback' => 'fppBackgroundMusicStartBackground');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'stop-background',
        'callback' => 'fppBackgroundMusicStopBackground');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'pause-background',
        'callback' => 'fppBackgroundMusicPauseBackground');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'resume-background',
        'callback' => 'fppBackgroundMusicResumeBackground');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'next-track',
        'callback' => 'fppBackgroundMusicNextTrack');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'previous-track',
        'callback' => 'fppBackgroundMusicPreviousTrack');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'jump-to-track',
        'callback' => 'fppBackgroundMusicJumpToTrack');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'start-show',
        'callback' => 'fppBackgroundMusicStartShow');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'set-volume',
        'callback' => 'fppBackgroundMusicSetVolume');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'save-settings',
        'callback' => 'fppBackgroundMusicSaveSettings');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'playlist-details',
        'callback' => 'fppBackgroundMusicPlaylistDetails');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'play-announcement',
        'callback' => 'fppBackgroundMusicPlayAnnouncement');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'stop-announcement',
        'callback' => 'fppBackgroundMusicStopAnnouncement');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'psa-status',
        'callback' => 'fppBackgroundMusicPSAStatus');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'check-update',
        'callback' => 'fppBackgroundMusicCheckUpdate');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'get-commit-history',
        'callback' => 'fppBackgroundMusicGetCommitHistory');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'get-log',
        'callback' => 'fppBackgroundMusicGetLog');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'download-log',
        'callback' => 'fppBackgroundMusicDownloadLog');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'reorder-playlist',
        'callback' => 'fppBackgroundMusicReorderPlaylist');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'tts-status',
        'callback' => 'fppBackgroundMusicTTSStatus');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'install-tts',
        'callback' => 'fppBackgroundMusicInstallTTS');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'generate-tts',
        'callback' => 'fppBackgroundMusicGenerateTTS');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'play-tts',
        'callback' => 'fppBackgroundMusicPlayTTS');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'tts-voices',
        'callback' => 'fppBackgroundMusicTTSVoices');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'install-voice',
        'callback' => 'fppBackgroundMusicInstallVoice');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'set-default-voice',
        'callback' => 'fppBackgroundMusicSetDefaultVoice');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'POST',
        'endpoint' => 'delete-voice',
        'callback' => 'fppBackgroundMusicDeleteVoice');
    array_push($result, $ep);
    
    $ep = array(
        'method' => 'GET',
        'endpoint' => 'system-diagnostics',
        'callback' => 'fppBackgroundMusicSystemDiagnostics');
    array_push($result, $ep);

    return $result;
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/version
function fppBackgroundMusicVersion() {
    $result = array();
    $result['version'] = 'fpp-BackgroundMusic v1.0';
    return json($result);
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/status
function fppBackgroundMusicStatus() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Load plugin config with error checking
    $pluginSettings = array();
    if (file_exists($pluginConfigFile)){
        // Check if file is readable
        if (!is_readable($pluginConfigFile)) {
            error_log("BackgroundMusic Plugin: Config file exists but is not readable: $pluginConfigFile");
            // Try to fix permissions
            @chmod($pluginConfigFile, 0644);
        }
        
        // Try to parse the file
        $pluginSettings = @parse_ini_file($pluginConfigFile);
        if ($pluginSettings === false) {
            error_log("BackgroundMusic Plugin: Failed to parse config file: $pluginConfigFile");
            $pluginSettings = array();
        }
    } else {
        error_log("BackgroundMusic Plugin: Config file does not exist: $pluginConfigFile");
    }
    
    // Get current brightness
    $brightness = getSetting('brightness');
    if ($brightness === false || $brightness === '') {
        $brightness = 100;
    }
    
    // Check running playlists
    $status = GetCurrentStatus();
    $currentPlaylist = isset($status['current_playlist']['playlist']) ? $status['current_playlist']['playlist'] : '';
    $fppStatus = isset($status['status_name']) ? $status['status_name'] : 'unknown';
    $currentSequence = isset($status['current_sequence']) ? $status['current_sequence'] : '';
    
    $backgroundMusicPlaylist = isset($pluginSettings['BackgroundMusicPlaylist']) ? $pluginSettings['BackgroundMusicPlaylist'] : '';
    $showPlaylist = isset($pluginSettings['ShowPlaylist']) ? $pluginSettings['ShowPlaylist'] : '';
    $returnToPreShow = isset($pluginSettings['ReturnToPreShow']) ? $pluginSettings['ReturnToPreShow'] : '1';
    $shuffleMusic = isset($pluginSettings['ShuffleMusic']) ? $pluginSettings['ShuffleMusic'] : '0';
    $volumeLevel = isset($pluginSettings['VolumeLevel']) ? intval($pluginSettings['VolumeLevel']) : 70;
    $backgroundMusicVolume = isset($pluginSettings['BackgroundMusicVolume']) ? intval($pluginSettings['BackgroundMusicVolume']) : $volumeLevel;
    $showPlaylistVolume = isset($pluginSettings['ShowPlaylistVolume']) ? intval($pluginSettings['ShowPlaylistVolume']) : 100;
    $postShowBackgroundVolume = isset($pluginSettings['PostShowBackgroundVolume']) ? intval($pluginSettings['PostShowBackgroundVolume']) : $backgroundMusicVolume;
    
    // Check if background music player is running (independent of FPP playlists)
    $pidFile = '/tmp/background_music_player.pid';
    $backgroundMusicRunning = false;
    if (file_exists($pidFile)) {
        $pid = trim(file_get_contents($pidFile));
        // Check if process is actually running
        exec("ps -p $pid > /dev/null 2>&1", $output, $returnCode);
        $backgroundMusicRunning = ($returnCode === 0);
    }
    
    // Get current track information if player is running
    $currentTrack = '';
    $trackDuration = 0;
    $trackElapsed = 0;
    $trackProgress = 0;
    $playbackState = 'stopped';
    $currentTrackNumber = 0;
    $totalTracks = 0;
    $streamSource = false;
    $streamTitle = '';
    $streamArtist = '';
    
    if ($backgroundMusicRunning) {
        $statusFile = '/tmp/bg_music_status.txt';
        if (file_exists($statusFile)) {
            // Read status file line by line to handle special characters properly
            $statusLines = file($statusFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
            $statusData = array();
            foreach ($statusLines as $line) {
                // Split on first = only
                $pos = strpos($line, '=');
                if ($pos !== false) {
                    $key = substr($line, 0, $pos);
                    $value = substr($line, $pos + 1);
                    $statusData[$key] = $value;
                }
            }
            
            if ($statusData) {
                // Check if this is a stream source
                $streamSource = isset($statusData['source']) && $statusData['source'] === 'stream';
                
                if ($streamSource) {
                    // Get stream metadata (ICY info)
                    $streamTitle = isset($statusData['stream_title']) ? $statusData['stream_title'] : '';
                    $streamArtist = isset($statusData['stream_artist']) ? $statusData['stream_artist'] : '';
                } else {
                    // Only populate track info for playlist mode, not for streams
                    $currentTrack = isset($statusData['filename']) ? $statusData['filename'] : '';
                    $trackDuration = isset($statusData['duration']) ? intval($statusData['duration']) : 0;
                    $trackElapsed = isset($statusData['elapsed']) ? intval($statusData['elapsed']) : 0;
                    $trackProgress = isset($statusData['progress']) ? intval($statusData['progress']) : 0;
                    $currentTrackNumber = isset($statusData['track_number']) ? intval($statusData['track_number']) : 0;
                    $totalTracks = isset($statusData['total_tracks']) ? intval($statusData['total_tracks']) : 0;
                }
                $playbackState = isset($statusData['state']) ? $statusData['state'] : 'playing';
            }
        }
    }
    
    // Check if a show is running
    // A show is considered running if:
    // 1. The configured show playlist is currently running in FPP, OR
    // 2. The background music playlist is running (handled separately)
    // NOTE: Other playlists (like lights-only sequences) are allowed to run alongside background music
    $showRunning = false;
    if ($currentPlaylist !== '' && $currentPlaylist !== $backgroundMusicPlaylist) {
        // Only consider it a "show" if it matches the configured show playlist
        // This allows lights-only sequences to run without blocking background music
        if (!empty($showPlaylist) && $currentPlaylist === $showPlaylist) {
            $showRunning = true;
        }
    }
    
    // Check if fpp-brightness plugin is installed (required for transitions)
    $brightnessPluginInstalled = file_exists('/home/fpp/media/plugins/fpp-brightness/libfpp-brightness.so');
    
    // Get current bgmplayer volume from PipeWire stream (query actual volume)
    $bgmplayerVolume = $backgroundMusicVolume; // default from config
    
    // Query PipeWire for actual stream volume
    // Note: We query all running BackgroundMusic streams and take the first result.
    // The player sets bgmplayer.role metadata to distinguish "main" vs "crossfade" streams,
    // but querying metadata requires per-stream lookups which is slower.
    // Since volume should be consistent across streams, we rely on the most recent stream.
    $fppUid = trim(shell_exec('id -u fpp'));
    $pwDumpCmd = "sudo -u fpp XDG_RUNTIME_DIR=/run/user/{$fppUid} pw-dump 2>/dev/null";
    $jqQuery = '.[] | select(.info.props["media.name"]? // "" | startswith("BackgroundMusic")) | select(.type == "PipeWire:Interface:Node") | select(.info.state? == "running") | .info.params.Props[0].volume';
    $streamVolume = trim(shell_exec("{$pwDumpCmd} | jq -r '{$jqQuery}' 2>/dev/null | tail -1"));
    
    if (!empty($streamVolume) && $streamVolume !== 'null' && is_numeric($streamVolume)) {
        // Convert from 0.0-1.0 to 0-100
        $bgmplayerVolume = intval($streamVolume * 100);
    }
    
    $result = array(
        'backgroundMusicRunning' => $backgroundMusicRunning,
        'showRunning' => $showRunning,
        'streamSource' => $streamSource,
        'brightness' => intval($brightness),
        'brightnessPluginInstalled' => $brightnessPluginInstalled,
        'currentPlaylist' => $currentPlaylist,
        'fppStatus' => $fppStatus,
        'currentSequence' => $currentSequence,
        'currentTrack' => $currentTrack,
        'trackDuration' => $trackDuration,
        'trackElapsed' => $trackElapsed,
        'trackProgress' => $trackProgress,
        'playbackState' => $playbackState,
        'currentTrackNumber' => $currentTrackNumber,
        'totalTracks' => $totalTracks,
        'streamTitle' => $streamTitle,
        'streamArtist' => $streamArtist,
        'volume' => $bgmplayerVolume,
        'config' => array(
            'backgroundMusicSource' => isset($pluginSettings['BackgroundMusicSource']) ? $pluginSettings['BackgroundMusicSource'] : 'playlist',
            'backgroundMusicPlaylist' => $backgroundMusicPlaylist,
            'backgroundMusicStreamURL' => isset($pluginSettings['BackgroundMusicStreamURL']) ? $pluginSettings['BackgroundMusicStreamURL'] : '',
            'showPlaylist' => $showPlaylist,
            'fadeTime' => isset($pluginSettings['FadeTime']) ? $pluginSettings['FadeTime'] : 5,
            'blackoutTime' => isset($pluginSettings['BlackoutTime']) ? $pluginSettings['BlackoutTime'] : 2,
            'returnToPreShow' => $returnToPreShow,
            'postShowDelay' => isset($pluginSettings['PostShowDelay']) ? $pluginSettings['PostShowDelay'] : 0,
            'shuffleMusic' => $shuffleMusic,
            'enableCrossfade' => isset($pluginSettings['EnableCrossfade']) && $pluginSettings['EnableCrossfade'] == '1' ? true : false,
            'crossfadeDuration' => isset($pluginSettings['CrossfadeDuration']) ? floatval($pluginSettings['CrossfadeDuration']) : 3,
            'volumeLevel' => $volumeLevel,
            'backgroundMusicVolume' => $backgroundMusicVolume,
            'showPlaylistVolume' => $showPlaylistVolume,
            'postShowBackgroundVolume' => $postShowBackgroundVolume,
            'PSAAnnouncementVolume' => isset($pluginSettings['PSAAnnouncementVolume']) ? $pluginSettings['PSAAnnouncementVolume'] : '90',
            'PSADuckVolume' => isset($pluginSettings['PSADuckVolume']) ? $pluginSettings['PSADuckVolume'] : '30'
        )
    );
    
    // Dynamically add all PSA button configurations (1-20)
    for ($i = 1; $i <= 20; $i++) {
        $result['config']['PSAButton' . $i . 'Label'] = isset($pluginSettings['PSAButton' . $i . 'Label']) ? $pluginSettings['PSAButton' . $i . 'Label'] : '';
        $result['config']['PSAButton' . $i . 'File'] = isset($pluginSettings['PSAButton' . $i . 'File']) ? $pluginSettings['PSAButton' . $i . 'File'] : '';
    }
    
    return json($result);
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/headerIndicator
function fppBackgroundMusicHeaderIndicator() {
    global $settings, $pluginConfigFile;
    
    // Get plugin status
    $pidFile = '/tmp/background_music_start.pid';
    $backgroundMusicRunning = false;
    
    if (file_exists($pidFile)) {
        $pid = trim(file_get_contents($pidFile));
        exec("ps -p $pid > /dev/null 2>&1", $output, $returnCode);
        $backgroundMusicRunning = ($returnCode === 0);
    }
    
    // Only return indicator if background music is running
    if (!$backgroundMusicRunning) {
        return json(null);
    }
    
    // Get current track info for tooltip
    $currentTrack = '';
    $streamSource = false;
    $streamTitle = '';
    
    $statusFile = '/tmp/bg_music_status.txt';
    if (file_exists($statusFile)) {
        $statusLines = file($statusFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
        $statusData = array();
        foreach ($statusLines as $line) {
            $pos = strpos($line, '=');
            if ($pos !== false) {
                $key = substr($line, 0, $pos);
                $value = substr($line, $pos + 1);
                $statusData[$key] = $value;
            }
        }
        
        if ($statusData) {
            $streamSource = isset($statusData['source']) && $statusData['source'] === 'stream';
            if ($streamSource) {
                $streamTitle = isset($statusData['stream_title']) ? $statusData['stream_title'] : '';
            } else {
                $currentTrack = isset($statusData['filename']) ? $statusData['filename'] : '';
            }
        }
    }
    
    // Build tooltip text
    $tooltip = 'Background Music Playing';
    if ($streamSource && !empty($streamTitle)) {
        $tooltip = 'Background Music: ' . $streamTitle;
    } elseif (!$streamSource && !empty($currentTrack)) {
        $tooltip = 'Background Music: ' . $currentTrack;
    }
    
    // Return indicator configuration
    $indicator = array(
        'visible' => true,
        'icon' => 'fa-music',
        'color' => '#8b5cf6',
        'tooltip' => $tooltip,
        'link' => '/plugin.php?_menu=status&plugin=fpp-plugin-BackgroundMusic&page=backgroundmusic.php',
        'animate' => 'pulse'
    );
    
    return json($indicator);
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/start-background
function fppBackgroundMusicStartBackground() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    if (file_exists($pluginConfigFile)){
        $pluginSettings = parse_ini_file($pluginConfigFile);
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Plugin not configured'));
    }
    
    // Check source type
    $source = isset($pluginSettings['BackgroundMusicSource']) ? $pluginSettings['BackgroundMusicSource'] : 'playlist';
    
    if ($source === 'stream') {
        $streamURL = isset($pluginSettings['BackgroundMusicStreamURL']) ? $pluginSettings['BackgroundMusicStreamURL'] : '';
        if (empty($streamURL)) {
            return json(array('status' => 'ERROR', 'message' => 'Stream URL not configured'));
        }
    } else {
        $backgroundMusicPlaylist = isset($pluginSettings['BackgroundMusicPlaylist']) ? $pluginSettings['BackgroundMusicPlaylist'] : '';
        if (empty($backgroundMusicPlaylist)) {
            return json(array('status' => 'ERROR', 'message' => 'Background music playlist not configured'));
        }
    }
    
    // Start background music using independent player (not FPP playlist system)
    // This allows music to play while FPP scheduler controls the sequence playlist
    // Run in background to avoid HTTP timeout during PipeWire initialization
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $logFile = '/tmp/background_music_start.log';
    $pidFile = '/tmp/background_music_start.pid';
    
    // Kill any previous stuck startup processes
    if (file_exists($pidFile)) {
        $oldPid = trim(file_get_contents($pidFile));
        if (!empty($oldPid) && is_numeric($oldPid)) {
            exec("ps -p " . escapeshellarg($oldPid) . " > /dev/null 2>&1 && kill " . escapeshellarg($oldPid) . " 2>/dev/null");
        }
    }
    
    // Start in background using wrapper script
    // The wrapper handles proper detachment from Apache
    $wrapperScript = dirname(__FILE__) . '/scripts/start_background_wrapper.sh';
    $cmd = "sudo " . escapeshellarg($wrapperScript);
    exec($cmd);
    
    // Give script time to start PipeWire, configure audio, and write PID file
    // Script can take 3-4 seconds when starting PipeWire
    sleep(5);
    file_put_contents('/tmp/api_debug.log', "After sleep, checking PID file: $pidFile\n", FILE_APPEND);
    
    // Check if the process started successfully
    if (file_exists($pidFile)) {
        $pid = trim(file_get_contents($pidFile));
        if (!empty($pid) && is_numeric($pid)) {
            exec("ps -p " . escapeshellarg($pid) . " > /dev/null 2>&1", $psOutput, $psReturn);
            if ($psReturn === 0) {
                return json(array('status' => 'OK', 'message' => 'Background music starting...', 'details' => 'Check /tmp/background_music_start.log for progress'));
            }
        }
    }
    
    // If we get here, something went wrong
    $errorLog = file_exists($logFile) ? file_get_contents($logFile) : 'No log file found';
    return json(array('status' => 'ERROR', 'message' => 'Failed to start background music', 'details' => $errorLog));
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/stop-background
function fppBackgroundMusicStopBackground() {
    // Stop the independent background music player
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $output = array();
    $returnCode = 0;
    exec("sudo /bin/bash " . escapeshellarg($scriptPath) . " stop 2>&1", $output, $returnCode);
    
    // Also stop any FPP playlist that might be playing background music
    // Check if a background music playlist is currently playing
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    if (file_exists($pluginConfigFile)) {
        $pluginSettings = parse_ini_file($pluginConfigFile);
        $bgMusicPlaylist = isset($pluginSettings['BackgroundMusicPlaylist']) ? $pluginSettings['BackgroundMusicPlaylist'] : '';
        
        // Get current FPP status
        $fppStatus = @file_get_contents('http://localhost/api/fppd/status');
        if ($fppStatus) {
            $statusData = json_decode($fppStatus, true);
            $currentPlaylist = isset($statusData['current_playlist']['playlist']) ? $statusData['current_playlist']['playlist'] : '';
            
            // If the current FPP playlist matches our background music playlist, stop it
            if (!empty($bgMusicPlaylist) && $currentPlaylist === $bgMusicPlaylist) {
                // Stop the FPP playlist
                @file_get_contents('http://localhost/api/playlists/stop');
            }
        }
    }
    
    return json(array('status' => 'OK', 'message' => 'Background music stopped'));
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/pause-background
function fppBackgroundMusicPauseBackground() {
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $output = array();
    $returnCode = 0;
    exec("sudo /bin/bash " . escapeshellarg($scriptPath) . " pause 2>&1", $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Background music paused'));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to pause background music', 'details' => implode("\n", $output)));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/resume-background
function fppBackgroundMusicResumeBackground() {
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $output = array();
    $returnCode = 0;
    exec("sudo /bin/bash " . escapeshellarg($scriptPath) . " resume 2>&1", $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Background music resumed'));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to resume background music', 'details' => implode("\n", $output)));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/next-track
function fppBackgroundMusicNextTrack() {
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $output = array();
    $returnCode = 0;
    exec("sudo /bin/bash " . escapeshellarg($scriptPath) . " next 2>&1", $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Skipped to next track'));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to skip track', 'details' => implode("\n", $output)));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/previous-track
function fppBackgroundMusicPreviousTrack() {
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $output = array();
    $returnCode = 0;
    exec("sudo /bin/bash " . escapeshellarg($scriptPath) . " previous 2>&1", $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Went to previous track'));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to go to previous track', 'details' => implode("\n", $output)));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/jump-to-track
function fppBackgroundMusicJumpToTrack() {
    $input = json_decode(file_get_contents('php://input'), true);
    $trackNumber = isset($input['trackNumber']) ? intval($input['trackNumber']) : 0;
    
    if ($trackNumber < 1) {
        return json(array('status' => 'ERROR', 'message' => 'Invalid track number'));
    }
    
    $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
    $output = array();
    $returnCode = 0;
    exec("sudo /bin/bash " . escapeshellarg($scriptPath) . " jump " . escapeshellarg($trackNumber) . " 2>&1", $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Jumped to track ' . $trackNumber));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to jump to track', 'details' => implode("\n", $output)));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/start-show
function fppBackgroundMusicStartShow() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    if (file_exists($pluginConfigFile)){
        $pluginSettings = parse_ini_file($pluginConfigFile);
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Plugin not configured'));
    }
    
    // Get POST data - check if a playlist name was passed in the request
    $input = json_decode(file_get_contents('php://input'), true);
    $showPlaylist = isset($input['playlist']) && !empty($input['playlist']) ? $input['playlist'] : '';
    
    // If no playlist was passed, fall back to configured ShowPlaylist
    if (empty($showPlaylist)) {
        $showPlaylist = isset($pluginSettings['ShowPlaylist']) ? $pluginSettings['ShowPlaylist'] : '';
    }
    
    $fadeTime = isset($pluginSettings['FadeTime']) ? intval($pluginSettings['FadeTime']) : 5;
    $blackoutTime = isset($pluginSettings['BlackoutTime']) ? intval($pluginSettings['BlackoutTime']) : 2;
    
    if (empty($showPlaylist)) {
        return json(array('status' => 'ERROR', 'message' => 'Show playlist not configured'));
    }
    
    // Execute the fade and show transition script in background via wrapper
    $wrapperScript = dirname(__FILE__) . '/scripts/start_show_wrapper.sh';
    $cmd = sprintf('sudo %s %d %d %s', 
        escapeshellarg($wrapperScript), 
        $fadeTime, 
        $blackoutTime, 
        escapeshellarg($showPlaylist));
    
    exec($cmd);
    
    return json(array('status' => 'OK', 'message' => 'Show transition started'));
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/set-volume
function fppBackgroundMusicSetVolume() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Get POST data
    $input = json_decode(file_get_contents('php://input'), true);
    $volume = isset($input['volume']) ? intval($input['volume']) : null;
    
    if ($volume === null || $volume < 0 || $volume > 100) {
        return json(array('status' => 'ERROR', 'message' => 'Invalid volume level. Must be between 0 and 100.'));
    }
    
    // Update the config file
    if (file_exists($pluginConfigFile)){
        $pluginSettings = parse_ini_file($pluginConfigFile);
    } else {
        $pluginSettings = array();
    }
    
    $pluginSettings['VolumeLevel'] = $volume;
    $pluginSettings['BackgroundMusicVolume'] = $volume;  // Update both for consistency
    
    // Write back to config file
    $configContent = "";
    foreach ($pluginSettings as $key => $value) {
        $configContent .= "$key=$value\n";
    }
    file_put_contents($pluginConfigFile, $configContent);
    
    // Apply volume change immediately to bgmplayer (not system volume)
    // This controls the player's internal volume via SIGUSR1/SIGUSR2 signals
    $scriptPath = dirname(__FILE__) . '/scripts/set_bgmplayer_volume.sh';
    exec("/bin/bash " . escapeshellarg($scriptPath) . " " . escapeshellarg($volume) . " 2>&1", $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Volume updated', 'volume' => $volume));
    } else {
        return json(array('status' => 'WARNING', 'message' => 'Volume saved but player may not be running', 'volume' => $volume));
    }
}

function GetCurrentStatus() {
    $ch = curl_init('http://localhost/api/fppd/status');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    $data = curl_exec($ch);
    curl_close($ch);
    return json_decode($data, true);
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/save-settings
function fppBackgroundMusicSaveSettings() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Get POST data
    $input = json_decode(file_get_contents('php://input'), true);
    
    if (!$input) {
        return json(array('status' => 'ERROR', 'message' => 'Invalid input data'));
    }
    
    // Write settings in INI format
    $configContent = "";
    foreach ($input as $key => $value) {
        // Quote values that contain spaces or special characters
        if (strpos($value, ' ') !== false || strpos($value, '"') !== false || strpos($value, '=') !== false) {
            // Escape any existing quotes and wrap in quotes
            $value = '"' . str_replace('"', '\\"', $value) . '"';
        }
        $configContent .= "$key=$value\n";
    }
    
    if (file_put_contents($pluginConfigFile, $configContent) !== false) {
        return json(array('status' => 'OK', 'message' => 'Settings saved successfully'));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to write settings file'));
    }
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/playlist-details
function fppBackgroundMusicPlaylistDetails() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    $result = array();
    $result['status'] = 'OK';
    $result['tracks'] = array();
    $result['playlistName'] = '';
    $result['totalDuration'] = 0;
    
    // Read plugin configuration
    if (file_exists($pluginConfigFile)) {
        $pluginSettings = parse_ini_file($pluginConfigFile);
        $playlistName = isset($pluginSettings['BackgroundMusicPlaylist']) ? $pluginSettings['BackgroundMusicPlaylist'] : '';
        
        if (!empty($playlistName)) {
            $result['playlistName'] = $playlistName;
            
            // Get playlist file path - FPP playlists are JSON files
            $playlistFile = $settings['playlistDirectory'] . '/' . $playlistName . '.json';
            
            if (file_exists($playlistFile)) {
                $playlistContent = file_get_contents($playlistFile);
                $playlistData = json_decode($playlistContent, true);
                
                if ($playlistData && isset($playlistData['mainPlaylist'])) {
                    $trackNum = 1;
                    foreach ($playlistData['mainPlaylist'] as $item) {
                        // Only include media items that are enabled
                        if ($item['type'] === 'media' && isset($item['enabled']) && $item['enabled'] == 1) {
                            $trackInfo = array();
                            $trackInfo['number'] = $trackNum;
                            $trackInfo['name'] = isset($item['mediaName']) ? $item['mediaName'] : 'Unknown';
                            
                            // Duration is already in the playlist JSON
                            $duration = isset($item['duration']) ? (int)$item['duration'] : 0;
                            $trackInfo['duration'] = $duration;
                            $trackInfo['durationFormatted'] = formatDuration($duration);
                            
                            $result['tracks'][] = $trackInfo;
                            $result['totalDuration'] += $duration;
                            $trackNum++;
                        }
                    }
                    
                    $result['totalDurationFormatted'] = formatDuration($result['totalDuration']);
                    $result['totalTracks'] = count($result['tracks']);
                } else {
                    $result['status'] = 'WARNING';
                    $result['message'] = 'Invalid playlist format';
                }
            } else {
                $result['status'] = 'WARNING';
                $result['message'] = 'Playlist file not found: ' . $playlistFile;
            }
        } else {
            $result['status'] = 'WARNING';
            $result['message'] = 'No background music playlist configured';
        }
    } else {
        $result['status'] = 'ERROR';
        $result['message'] = 'Plugin not configured';
    }
    
    return json($result);
}

function formatDuration($seconds) {
    if ($seconds < 60) {
        return $seconds . 's';
    } else if ($seconds < 3600) {
        $minutes = floor($seconds / 60);
        $secs = $seconds % 60;
        return sprintf('%d:%02d', $minutes, $secs);
    } else {
        $hours = floor($seconds / 3600);
        $minutes = floor(($seconds % 3600) / 60);
        $secs = $seconds % 60;
        return sprintf('%d:%02d:%02d', $hours, $minutes, $secs);
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/play-announcement
function fppBackgroundMusicPlayAnnouncement() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Load plugin config
    if (!file_exists($pluginConfigFile)) {
        return json(array('status' => 'ERROR', 'message' => 'Plugin not configured'));
    }
    
    $pluginSettings = parse_ini_file($pluginConfigFile);
    
    // Get input data
    $input = json_decode(file_get_contents('php://input'), true);
    $buttonNumber = isset($input['buttonNumber']) ? intval($input['buttonNumber']) : 0;
    
    if ($buttonNumber < 1 || $buttonNumber > 20) {
        return json(array('status' => 'ERROR', 'message' => 'Invalid button number (must be 1-20)'));
    }
    
    // Get announcement configuration
    $announcementFile = isset($pluginSettings['PSAButton' . $buttonNumber . 'File']) ? $pluginSettings['PSAButton' . $buttonNumber . 'File'] : '';
    $announcementLabel = isset($pluginSettings['PSAButton' . $buttonNumber . 'Label']) ? $pluginSettings['PSAButton' . $buttonNumber . 'Label'] : 'PSA #' . $buttonNumber;
    $announcementVolume = isset($pluginSettings['PSAAnnouncementVolume']) ? intval($pluginSettings['PSAAnnouncementVolume']) : 90;
    $duckVolume = isset($pluginSettings['PSADuckVolume']) ? intval($pluginSettings['PSADuckVolume']) : 30;
    
    if (empty($announcementFile)) {
        return json(array('status' => 'ERROR', 'message' => 'Announcement button not configured'));
    }
    
    if (!file_exists($announcementFile)) {
        return json(array('status' => 'ERROR', 'message' => 'Announcement file not found: ' . $announcementFile));
    }
    
    // Call the play_announcement script
    $scriptPath = dirname(__FILE__) . '/scripts/play_announcement.sh';
    $output = array();
    $returnCode = 0;
    
    $cmd = "/bin/bash " . escapeshellarg($scriptPath) . " " . 
           escapeshellarg($announcementFile) . " " . 
           escapeshellarg($duckVolume) . " " . 
           escapeshellarg($announcementVolume) . " " . 
           escapeshellarg($buttonNumber) . " " . 
           escapeshellarg($announcementLabel) . " 2>&1";
    
    exec($cmd, $output, $returnCode);
    
    if ($returnCode === 0) {
        return json(array('status' => 'OK', 'message' => 'Announcement started'));
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Failed to play announcement', 'details' => implode("\n", $output)));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/stop-announcement
function fppBackgroundMusicStopAnnouncement() {
    $pidFile = '/tmp/announcement_player.pid';
    
    if (!file_exists($pidFile)) {
        return json(array('status' => 'OK', 'message' => 'No announcement playing'));
    }
    
    $pid = trim(file_get_contents($pidFile));
    
    // Kill the announcement process
    exec("kill $pid 2>&1", $output, $returnCode);
    
    // Clean up PID file
    @unlink($pidFile);
    
    return json(array('status' => 'OK', 'message' => 'Announcement stopped'));
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/psa-status
function fppBackgroundMusicPSAStatus() {
    $pidFile = '/tmp/announcement_player.pid';
    $statusFile = '/tmp/announcement_status.txt';
    $playing = false;
    $buttonNumber = 0;
    $buttonLabel = '';
    $announcementFile = '';
    $duration = 0;
    $elapsed = 0;
    $progress = 0;
    $maxDuration = 300; // 5 minutes max for any announcement
    
    if (file_exists($pidFile)) {
        $pid = trim(file_get_contents($pidFile));
        // Check if process is actually running
        exec("ps -p $pid > /dev/null 2>&1", $output, $returnCode);
        $playing = ($returnCode === 0);
        
        // If playing, read status information
        if ($playing && file_exists($statusFile)) {
            $statusData = parse_ini_file($statusFile);
            if ($statusData) {
                $buttonNumber = isset($statusData['buttonNumber']) ? intval($statusData['buttonNumber']) : 0;
                $buttonLabel = isset($statusData['buttonLabel']) ? $statusData['buttonLabel'] : '';
                $announcementFile = isset($statusData['announcementFile']) ? $statusData['announcementFile'] : '';
                $duration = isset($statusData['duration']) ? intval($statusData['duration']) : 0;
                
                // Calculate elapsed time and progress
                if (isset($statusData['startTime'])) {
                    $startTime = intval($statusData['startTime']);
                    $elapsed = time() - $startTime;
                    
                    // Calculate progress percentage
                    if ($duration > 0) {
                        $progress = min(100, round(($elapsed / $duration) * 100));
                    }
                    
                    // Check if announcement has been running too long (stuck)
                    if ($elapsed > $maxDuration) {
                        error_log("BackgroundMusic: PSA stuck for $elapsed seconds, killing process $pid");
                        // Kill stuck process
                        exec("kill $pid 2>&1");
                        $playing = false;
                    }
                }
            }
        }
        
        // If not playing but PID file exists, clean it up
        if (!$playing) {
            @unlink($pidFile);
            @unlink($statusFile);
        }
    } else {
        // No PID file - ensure status file is also cleaned up
        if (file_exists($statusFile)) {
            @unlink($statusFile);
        }
    }
    
    $result = array(
        'status' => 'OK',
        'playing' => $playing,
        'buttonNumber' => $buttonNumber,
        'buttonLabel' => $buttonLabel,
        'announcementFile' => $announcementFile,
        'duration' => $duration,
        'elapsed' => $elapsed,
        'progress' => $progress
    );
    
    return json($result);
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/check-update
function fppBackgroundMusicCheckUpdate() {
    $pluginDir = dirname(__FILE__);
    $result = array(
        'status' => 'OK',
        'hasUpdate' => false,
        'currentCommit' => '',
        'latestCommit' => '',
        'currentCommitShort' => '',
        'latestCommitShort' => '',
        'behindBy' => 0,
        'lastChecked' => time(),
        'canConnect' => false,
        'branch' => 'master',
        'repoURL' => 'https://github.com/OnlineDynamic/BackgroundMusicFPP-Plugin'
    );
    
    // Determine which branch to check based on FPP version
    $pluginInfoFile = $pluginDir . '/pluginInfo.json';
    $branch = 'master'; // Default fallback
    
    if (file_exists($pluginInfoFile)) {
        $pluginInfo = json_decode(file_get_contents($pluginInfoFile), true);
        if ($pluginInfo && isset($pluginInfo['versions']) && is_array($pluginInfo['versions'])) {
            // Get FPP version
            $fppVersion = getFPPVersion();
            $fppVersionParts = explode('.', $fppVersion);
            $fppMajor = isset($fppVersionParts[0]) ? intval($fppVersionParts[0]) : 0;
            $fppMinor = isset($fppVersionParts[1]) ? intval($fppVersionParts[1]) : 0;
            
            // Find matching version config
            foreach ($pluginInfo['versions'] as $versionConfig) {
                $minFPP = isset($versionConfig['minFPPVersion']) ? $versionConfig['minFPPVersion'] : '0.0';
                $maxFPP = isset($versionConfig['maxFPPVersion']) ? $versionConfig['maxFPPVersion'] : '0';
                $configBranch = isset($versionConfig['branch']) ? $versionConfig['branch'] : 'master';
                
                $minParts = explode('.', $minFPP);
                $minMajor = isset($minParts[0]) ? intval($minParts[0]) : 0;
                $minMinor = isset($minParts[1]) ? intval($minParts[1]) : 0;
                
                // Check if FPP version >= minFPPVersion
                $meetsMin = ($fppMajor > $minMajor) || ($fppMajor == $minMajor && $fppMinor >= $minMinor);
                
                // Check maxFPPVersion (0 means no maximum)
                $meetsMax = false;
                if ($maxFPP === '0' || $maxFPP === 0) {
                    $meetsMax = true;
                } else {
                    $maxParts = explode('.', $maxFPP);
                    $maxMajor = isset($maxParts[0]) ? intval($maxParts[0]) : 0;
                    $maxMinor = isset($maxParts[1]) ? intval($maxParts[1]) : 0;
                    $meetsMax = ($fppMajor < $maxMajor) || ($fppMajor == $maxMajor && $fppMinor <= $maxMinor);
                }
                
                if ($meetsMin && $meetsMax) {
                    $branch = $configBranch;
                    break;
                }
            }
        }
    }
    
    $result['branch'] = $branch;
    
    // Check if we can connect to the internet (check GitHub)
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "https://github.com");
    curl_setopt($ch, CURLOPT_NOBODY, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 3);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    $result['canConnect'] = ($httpCode >= 200 && $httpCode < 400);
    
    if (!$result['canConnect']) {
        $result['message'] = 'Cannot connect to GitHub - check internet connection';
        return json($result);
    }
    
    // Get current commit hash
    $currentCommit = trim(shell_exec("cd " . escapeshellarg($pluginDir) . " && git rev-parse HEAD 2>/dev/null"));
    if (empty($currentCommit)) {
        $result['status'] = 'ERROR';
        $result['message'] = 'Failed to get current git commit';
        return json($result);
    }
    
    $result['currentCommit'] = $currentCommit;
    $result['currentCommitShort'] = substr($currentCommit, 0, 7);
    
    // Fetch latest from remote for the appropriate branch
    exec("cd " . escapeshellarg($pluginDir) . " && git fetch origin " . escapeshellarg($branch) . " 2>&1", $fetchOutput, $fetchReturn);
    
    if ($fetchReturn !== 0) {
        $result['status'] = 'ERROR';
        $result['message'] = 'Failed to fetch updates from remote repository';
        return json($result);
    }
    
    // Get latest commit hash from remote branch
    $latestCommit = trim(shell_exec("cd " . escapeshellarg($pluginDir) . " && git rev-parse origin/" . escapeshellarg($branch) . " 2>/dev/null"));
    if (empty($latestCommit)) {
        $result['status'] = 'ERROR';
        $result['message'] = 'Failed to get latest commit from remote';
        return json($result);
    }
    
    $result['latestCommit'] = $latestCommit;
    $result['latestCommitShort'] = substr($latestCommit, 0, 7);
    
    // Check if we're behind
    if ($currentCommit !== $latestCommit) {
        $result['hasUpdate'] = true;
        
        // Get number of commits behind
        $behindCount = trim(shell_exec("cd " . escapeshellarg($pluginDir) . " && git rev-list --count HEAD..origin/" . escapeshellarg($branch) . " 2>/dev/null"));
        $result['behindBy'] = intval($behindCount);
        
        // Get latest commit details
        $commitInfo = shell_exec("cd " . escapeshellarg($pluginDir) . " && git log origin/" . escapeshellarg($branch) . " -1 --pretty=format:'%s|%an|%ar' 2>/dev/null");
        if (!empty($commitInfo)) {
            $parts = explode('|', $commitInfo);
            $result['latestCommitMessage'] = isset($parts[0]) ? $parts[0] : '';
            $result['latestCommitAuthor'] = isset($parts[1]) ? $parts[1] : '';
            $result['latestCommitDate'] = isset($parts[2]) ? $parts[2] : '';
        }
    }
    
    return json($result);
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/reorder-playlist
function fppBackgroundMusicReorderPlaylist() {
    global $settings;
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Get POST data
    $input = json_decode(file_get_contents('php://input'), true);
    $trackOrder = isset($input['trackOrder']) ? $input['trackOrder'] : null;
    
    if (!is_array($trackOrder) || count($trackOrder) === 0) {
        return json(array('status' => 'ERROR', 'message' => 'Invalid track order data'));
    }
    
    // Read plugin configuration to get playlist name
    if (file_exists($pluginConfigFile)) {
        $pluginSettings = parse_ini_file($pluginConfigFile);
        $playlistName = isset($pluginSettings['BackgroundMusicPlaylist']) ? $pluginSettings['BackgroundMusicPlaylist'] : '';
        
        if (empty($playlistName)) {
            return json(array('status' => 'ERROR', 'message' => 'No background music playlist configured'));
        }
        
        // Get playlist file path
        $playlistFile = $settings['playlistDirectory'] . '/' . $playlistName . '.json';
        
        if (!file_exists($playlistFile)) {
            return json(array('status' => 'ERROR', 'message' => 'Playlist file not found'));
        }
        
        // Read and parse playlist
        $playlistContent = file_get_contents($playlistFile);
        $playlistData = json_decode($playlistContent, true);
        
        if (!$playlistData || !isset($playlistData['mainPlaylist'])) {
            return json(array('status' => 'ERROR', 'message' => 'Invalid playlist format'));
        }
        
        // Extract only the media items that are enabled
        $mediaItems = array();
        $otherItems = array();
        foreach ($playlistData['mainPlaylist'] as $item) {
            if ($item['type'] === 'media' && isset($item['enabled']) && $item['enabled'] == 1) {
                $mediaItems[] = $item;
            } else {
                $otherItems[] = $item;
            }
        }
        
        // Verify track order matches the number of media items
        if (count($trackOrder) !== count($mediaItems)) {
            return json(array('status' => 'ERROR', 'message' => 'Track order count does not match playlist'));
        }
        
        // Reorder the media items based on trackOrder array (0-indexed)
        $reorderedMedia = array();
        foreach ($trackOrder as $oldIndex) {
            if (isset($mediaItems[$oldIndex])) {
                $reorderedMedia[] = $mediaItems[$oldIndex];
            }
        }
        
        // Merge back with other items (keep non-media items in their original positions)
        // For simplicity, we'll put all media items first, then other items
        $playlistData['mainPlaylist'] = array_merge($reorderedMedia, $otherItems);
        
        // Write back to file with pretty printing
        $jsonOutput = json_encode($playlistData, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
        if (file_put_contents($playlistFile, $jsonOutput) !== false) {
            // Check if background music is running
            $scriptPath = dirname(__FILE__) . '/scripts/background_music_player.sh';
            exec("/bin/bash " . escapeshellarg($scriptPath) . " status 2>&1", $statusOutput, $statusReturn);
            
            if ($statusReturn === 0) {
                // It's running - regenerate the m3u playlist file so it picks up the new order
                // The player will continue the current track and use the new order afterwards
                $m3uFile = '/tmp/background_music_playlist.m3u';
                $m3uContent = "#EXTM3U\n";
                foreach ($reorderedMedia as $item) {
                    $mediaName = isset($item['mediaName']) ? $item['mediaName'] : '';
                    if (!empty($mediaName)) {
                        $m3uContent .= "/home/fpp/media/music/" . $mediaName . "\n";
                    }
                }
                file_put_contents($m3uFile, $m3uContent);
                
                // Create signal file to tell player that playlist was reordered
                file_put_contents('/tmp/bg_music_reorder.txt', '1');
                
                return json(array('status' => 'OK', 'message' => 'Playlist reordered - will apply after current track'));
            } else {
                return json(array('status' => 'OK', 'message' => 'Playlist reordered successfully'));
            }
        } else {
            return json(array('status' => 'ERROR', 'message' => 'Failed to save playlist file'));
        }
    } else {
        return json(array('status' => 'ERROR', 'message' => 'Plugin not configured'));
    }
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/get-commit-history
function fppBackgroundMusicGetCommitHistory() {
    $pluginDir = dirname(__FILE__);
    
    // Check if this is a Git repository
    if (!is_dir($pluginDir . '/.git')) {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Not a Git repository. This may be a manual installation.',
            'commits' => array()
        ));
    }
    
    // Get the last 50 commits
    $gitCommand = "cd " . escapeshellarg($pluginDir) . " && git log -50 --pretty=format:'%H|%an|%ae|%ad|%s' --date=iso 2>&1";
    $output = array();
    $returnVar = 0;
    
    exec($gitCommand, $output, $returnVar);
    
    if ($returnVar !== 0) {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Failed to execute git log command',
            'commits' => array()
        ));
    }
    
    $commits = array();
    foreach ($output as $line) {
        $parts = explode('|', $line, 5);
        if (count($parts) === 5) {
            $commits[] = array(
                'hash' => $parts[0],
                'author' => $parts[1],
                'email' => $parts[2],
                'date' => $parts[3],
                'message' => $parts[4]
            );
        }
    }
    
    return json(array(
        'status' => 'OK',
        'commits' => $commits,
        'count' => count($commits)
    ));
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/tts-status
function fppBackgroundMusicTTSStatus() {
    $pluginDir = dirname(__FILE__);
    $piperDir = $pluginDir . '/piper';
    $piperBin = $piperDir . '/piper';
    $statusFile = $piperDir . '/status.txt';
    
    $status = array(
        'installed' => false,
        'version' => 'unknown',
        'architecture' => 'unknown',
        'installDate' => '',
        'voices' => array(),
        'defaultVoice' => '',
        'functional' => false
    );
    
    // Check if binary exists and is executable
    if (file_exists($piperBin) && is_executable($piperBin)) {
        $status['installed'] = true;
        
        // Read status file if it exists
        if (file_exists($statusFile)) {
            $statusLines = file($statusFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
            foreach ($statusLines as $line) {
                if (strpos($line, 'version:') === 0) {
                    $status['version'] = trim(substr($line, 8));
                } elseif (strpos($line, 'architecture:') === 0) {
                    $status['architecture'] = trim(substr($line, 13));
                } elseif (preg_match('/^\d{4}-\d{2}-\d{2}/', $line)) {
                    $status['installDate'] = trim($line);
                }
            }
        }
        
        // If status file doesn't exist or is incomplete, installation may be broken
        if ($status['version'] === 'unknown' || $status['architecture'] === 'unknown') {
            $status['installed'] = true; // Binary exists
            $status['functional'] = false; // But might not work
            $status['message'] = 'Piper binary found but installation may be incomplete. Version/architecture unknown. Try reinstalling Piper.';
        }
        
        // List available voices
        $voicesDir = $piperDir . '/voices';
        if (is_dir($voicesDir)) {
            $voices = glob($voicesDir . '/*.onnx');
            foreach ($voices as $voice) {
                $voiceName = basename($voice, '.onnx');
                $status['voices'][] = $voiceName;
            }
        }
        
        // Check default voice exists
        if (file_exists($piperDir . '/default_voice.onnx')) {
            $defaultLink = readlink($piperDir . '/default_voice.onnx');
            if ($defaultLink) {
                $status['defaultVoice'] = basename($defaultLink, '.onnx');
            }
        }
        
        // Mark as functional only if we have version info and at least one voice
        if ($status['version'] !== 'unknown' && !empty($status['voices'])) {
            $status['functional'] = true;
        }
    }
    
    return json($status);
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/install-tts
function fppBackgroundMusicInstallTTS() {
    $pluginDir = dirname(__FILE__);
    $installScript = $pluginDir . '/scripts/install_piper.sh';
    
    if (!file_exists($installScript)) {
        return json(array('status' => 'ERROR', 'message' => 'Installation script not found'));
    }
    
    // Run installation in background
    $logFile = '/tmp/piper_install.log';
    $cmd = "bash " . escapeshellarg($installScript) . " > " . escapeshellarg($logFile) . " 2>&1 &";
    exec($cmd);
    
    return json(array(
        'status' => 'OK', 
        'message' => 'Piper TTS installation started. This may take several minutes.',
        'logFile' => $logFile
    ));
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/generate-tts
function fppBackgroundMusicGenerateTTS() {
    global $settings;
    $pluginDir = dirname(__FILE__);
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Get POST data
    $data = json_decode(file_get_contents('php://input'), true);
    
    if (!isset($data['text']) || empty($data['text'])) {
        return json(array('status' => 'ERROR', 'message' => 'No text provided'));
    }
    
    if (!isset($data['filename']) || empty($data['filename'])) {
        return json(array('status' => 'ERROR', 'message' => 'No filename provided'));
    }
    
    $text = $data['text'];
    $filename = $data['filename'];
    $voice = isset($data['voice']) ? $data['voice'] : '';
    
    // Get TTS engine preference from config
    $ttsEngine = 'piper'; // default
    if (file_exists($pluginConfigFile)) {
        $pluginSettings = parse_ini_file($pluginConfigFile);
        if (isset($pluginSettings['TTSEngine'])) {
            $ttsEngine = strtolower($pluginSettings['TTSEngine']);
        }
    }
    
    // Sanitize filename
    $filename = preg_replace('/[^a-zA-Z0-9_\-]/', '_', $filename);
    if (!preg_match('/\.mp3$/', $filename)) {
        $filename .= '.mp3';
    }
    
    // Select appropriate script based on engine
    if ($ttsEngine === 'elevenlabs') {
        // ElevenLabs
        $generateScript = $pluginDir . '/scripts/generate_tts_elevenlabs.sh';
        $cmd = "bash " . escapeshellarg($generateScript) . " " . 
               escapeshellarg($text) . " " . 
               escapeshellarg($filename);
        
        if (!empty($voice)) {
            $cmd .= " " . escapeshellarg($voice);
        }
    } else {
        // Piper (default)
        $piperBin = $pluginDir . '/piper/piper';
        
        // Check if Piper is installed
        if (!file_exists($piperBin)) {
            return json(array(
                'status' => 'ERROR', 
                'message' => 'Piper TTS not installed. Please install it first or switch to ElevenLabs.'
            ));
        }
        
        $generateScript = $pluginDir . '/scripts/generate_tts.sh';
        $cmd = "bash " . escapeshellarg($generateScript) . " " . 
               escapeshellarg($text) . " " . 
               escapeshellarg($filename);
        
        if (!empty($voice)) {
            $cmd .= " " . escapeshellarg($voice);
        }
    }
    
    $cmd .= " 2>&1";
    
    $output = array();
    $returnVar = 0;
    exec($cmd, $output, $returnVar);
    
    if ($returnVar === 0) {
        return json(array(
            'status' => 'OK',
            'message' => 'TTS audio generated successfully using ' . ucfirst($ttsEngine),
            'filename' => $filename,
            'path' => '/home/fpp/media/music/' . $filename,
            'engine' => $ttsEngine
        ));
    } else {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Failed to generate TTS audio',
            'details' => implode("\n", $output)
        ));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/play-tts
function fppBackgroundMusicPlayTTS() {
    $pluginDir = dirname(__FILE__);
    $piperBin = $pluginDir . '/piper/piper';
    
    // Check if Piper is installed
    if (!file_exists($piperBin)) {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Piper TTS not installed. Please install it first.'
        ));
    }
    
    // Get POST data
    $data = json_decode(file_get_contents('php://input'), true);
    
    if (!isset($data['text']) || empty($data['text'])) {
        return json(array('status' => 'ERROR', 'message' => 'No text provided'));
    }
    
    $text = $data['text'];
    $voice = isset($data['voice']) ? $data['voice'] : '';
    
    // Build command
    $playScript = $pluginDir . '/scripts/play_tts_announcement.sh';
    $cmd = "bash " . escapeshellarg($playScript) . " " . escapeshellarg($text);
    
    if (!empty($voice)) {
        $cmd .= " " . escapeshellarg($voice);
    }
    
    $cmd .= " > /dev/null 2>&1 &";
    
    exec($cmd);
    
    return json(array(
        'status' => 'OK',
        'message' => 'TTS announcement started'
    ));
}

// GET /api/plugin/fpp-plugin-BackgroundMusic/tts-voices
function fppBackgroundMusicTTSVoices() {
    global $settings;
    $pluginDir = dirname(__FILE__);
    $pluginConfigFile = $settings['configDirectory'] . "/plugin.fpp-plugin-BackgroundMusic";
    
    // Get TTS engine from query parameter or config
    $ttsEngine = 'piper';
    if (isset($_GET['engine'])) {
        // Use engine from query parameter (user's current selection)
        $ttsEngine = strtolower($_GET['engine']);
    } else if (file_exists($pluginConfigFile)) {
        // Fall back to saved config
        $pluginSettings = parse_ini_file($pluginConfigFile);
        if (isset($pluginSettings['TTSEngine'])) {
            $ttsEngine = strtolower($pluginSettings['TTSEngine']);
        }
    }
    
    // Get ElevenLabs API key from config
    $elevenLabsAPIKey = '';
    if (file_exists($pluginConfigFile)) {
        $pluginSettings = parse_ini_file($pluginConfigFile);
        if (isset($pluginSettings['ElevenLabsAPIKey'])) {
            $elevenLabsAPIKey = $pluginSettings['ElevenLabsAPIKey'];
        }
    }
    
    // Handle ElevenLabs voices
    if ($ttsEngine === 'elevenlabs') {
        if (empty($elevenLabsAPIKey)) {
            return json(array(
                'status' => 'ERROR',
                'message' => 'ElevenLabs API key not configured'
            ));
        }
        
        // Fetch voices from ElevenLabs API
        $ch = curl_init('https://api.elevenlabs.io/v1/voices');
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
            'xi-api-key: ' . $elevenLabsAPIKey
        ));
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        
        if ($httpCode !== 200 || !$response) {
            return json(array(
                'status' => 'ERROR',
                'message' => 'Failed to fetch voices from ElevenLabs (HTTP ' . $httpCode . ')'
            ));
        }
        
        $voicesData = json_decode($response, true);
        if (!$voicesData || !isset($voicesData['voices'])) {
            return json(array(
                'status' => 'ERROR',
                'message' => 'Invalid response from ElevenLabs API'
            ));
        }
        
        // Format voices for UI
        $formattedVoices = array();
        foreach ($voicesData['voices'] as $voice) {
            $formattedVoices[] = array(
                'id' => $voice['voice_id'],
                'name' => $voice['name'],
                'description' => isset($voice['description']) ? $voice['description'] : '',
                'category' => isset($voice['category']) ? $voice['category'] : 'general',
                'gender' => isset($voice['labels']['gender']) ? $voice['labels']['gender'] : 'unknown',
                'accent' => isset($voice['labels']['accent']) ? $voice['labels']['accent'] : 'unknown',
                'age' => isset($voice['labels']['age']) ? $voice['labels']['age'] : 'unknown',
                'use_case' => isset($voice['labels']['use case']) ? $voice['labels']['use case'] : 'general',
                'preview_url' => isset($voice['preview_url']) ? $voice['preview_url'] : '',
                'installed' => true,  // All cloud voices are "available"
                'is_default' => false,
                'engine' => 'elevenlabs'
            );
        }
        
        return json(array(
            'status' => 'OK',
            'engine' => 'elevenlabs',
            'voices' => $formattedVoices,
            'total_count' => count($formattedVoices)
        ));
    }
    
    // Handle Piper voices (existing code)
    $piperDir = $pluginDir . '/piper';
    $voicesDir = $piperDir . '/voices';
    $availableVoicesFile = $piperDir . '/available_voices.json';
    
    // Load available voices catalog
    $availableVoices = array();
    if (file_exists($availableVoicesFile)) {
        $jsonContent = file_get_contents($availableVoicesFile);
        $voicesData = json_decode($jsonContent, true);
        if ($voicesData && isset($voicesData['voices'])) {
            $availableVoices = $voicesData['voices'];
        }
    }
    
    // Get installed voices
    $installedVoices = array();
    if (is_dir($voicesDir)) {
        $voiceFiles = glob($voicesDir . '/*.onnx');
        foreach ($voiceFiles as $voiceFile) {
            $voiceId = basename($voiceFile, '.onnx');
            $installedVoices[] = $voiceId;
        }
    }
    
    // Get default voice
    $defaultVoice = '';
    if (file_exists($piperDir . '/default_voice.onnx')) {
        $defaultLink = readlink($piperDir . '/default_voice.onnx');
        if ($defaultLink) {
            $defaultVoice = basename($defaultLink, '.onnx');
        }
    }
    
    // Merge installed status with available voices
    foreach ($availableVoices as &$voice) {
        $voice['installed'] = in_array($voice['id'], $installedVoices);
        $voice['is_default'] = ($voice['id'] === $defaultVoice);
        $voice['engine'] = 'piper';
    }
    
    return json(array(
        'status' => 'OK',
        'engine' => 'piper',
        'voices' => $availableVoices,
        'installed_count' => count($installedVoices),
        'default_voice' => $defaultVoice
    ));
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/install-voice
function fppBackgroundMusicInstallVoice() {
    $pluginDir = dirname(__FILE__);
    $installScript = $pluginDir . '/scripts/install_voice.sh';
    
    if (!file_exists($installScript)) {
        return json(array('status' => 'ERROR', 'message' => 'Voice installation script not found'));
    }
    
    // Get POST data
    $data = json_decode(file_get_contents('php://input'), true);
    
    if (!isset($data['voice_id']) || empty($data['voice_id'])) {
        return json(array('status' => 'ERROR', 'message' => 'No voice ID provided'));
    }
    
    $voiceId = $data['voice_id'];
    
    // Run installation
    $cmd = "bash " . escapeshellarg($installScript) . " " . escapeshellarg($voiceId) . " 2>&1";
    $output = array();
    $returnVar = 0;
    exec($cmd, $output, $returnVar);
    
    if ($returnVar === 0) {
        return json(array(
            'status' => 'OK',
            'message' => 'Voice installed successfully',
            'voice_id' => $voiceId
        ));
    } else {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Failed to install voice',
            'details' => implode("\n", $output)
        ));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/set-default-voice
function fppBackgroundMusicSetDefaultVoice() {
    $pluginDir = dirname(__FILE__);
    $piperDir = $pluginDir . '/piper';
    $voicesDir = $piperDir . '/voices';
    
    // Get POST data
    $data = json_decode(file_get_contents('php://input'), true);
    
    if (!isset($data['voice_id']) || empty($data['voice_id'])) {
        return json(array('status' => 'ERROR', 'message' => 'No voice ID provided'));
    }
    
    $voiceId = $data['voice_id'];
    $voiceFile = $voicesDir . '/' . $voiceId . '.onnx';
    $voiceConfigFile = $voicesDir . '/' . $voiceId . '.onnx.json';
    
    // Check if voice exists
    if (!file_exists($voiceFile)) {
        return json(array('status' => 'ERROR', 'message' => 'Voice not installed'));
    }
    
    $defaultVoiceLink = $piperDir . '/default_voice.onnx';
    $defaultVoiceConfigLink = $piperDir . '/default_voice.onnx.json';
    
    // Remove old symlinks (check is_link first, not file_exists)
    if (is_link($defaultVoiceLink)) {
        unlink($defaultVoiceLink);
    }
    if (is_link($defaultVoiceConfigLink)) {
        unlink($defaultVoiceConfigLink);
    }
    
    // Create new symlinks
    $symlinkResult1 = symlink($voiceFile, $defaultVoiceLink);
    $symlinkResult2 = symlink($voiceConfigFile, $defaultVoiceConfigLink);
    
    if ($symlinkResult1 && $symlinkResult2) {
        return json(array(
            'status' => 'OK',
            'message' => 'Default voice set successfully',
            'voice_id' => $voiceId
        ));
    } else {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Failed to create symlinks. Check permissions.'
        ));
    }
}

// POST /api/plugin/fpp-plugin-BackgroundMusic/delete-voice
function fppBackgroundMusicDeleteVoice() {
    $pluginDir = dirname(__FILE__);
    $piperDir = $pluginDir . '/piper';
    $voicesDir = $piperDir . '/voices';
    
    // Get POST data
    $data = json_decode(file_get_contents('php://input'), true);
    
    if (!isset($data['voice_id']) || empty($data['voice_id'])) {
        return json(array('status' => 'ERROR', 'message' => 'No voice ID provided'));
    }
    
    $voiceId = $data['voice_id'];
    $voiceFile = $voicesDir . '/' . $voiceId . '.onnx';
    $voiceConfigFile = $voicesDir . '/' . $voiceId . '.onnx.json';
    
    // Check if this is the default voice
    $defaultVoice = '';
    if (file_exists($piperDir . '/default_voice.onnx')) {
        $defaultLink = readlink($piperDir . '/default_voice.onnx');
        if ($defaultLink) {
            $defaultVoice = basename($defaultLink, '.onnx');
        }
    }
    
    if ($defaultVoice === $voiceId) {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Cannot delete default voice. Set a different default voice first.'
        ));
    }
    
    // Delete voice files
    $deleted1 = @unlink($voiceFile);
    $deleted2 = @unlink($voiceConfigFile);
    
    if ($deleted1 || $deleted2) {
        return json(array(
            'status' => 'OK',
            'message' => 'Voice deleted successfully',
            'voice_id' => $voiceId
        ));
    } else {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Failed to delete voice files'
        ));
    }
}

function fppBackgroundMusicGetLog() {
    $logFile = '/home/fpp/media/logs/fpp-plugin-BackgroundMusic.log';
    
    if (!file_exists($logFile)) {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Log file not found',
            'log' => ''
        ));
    }
    
    // Get number of lines to return
    $lines = isset($_GET['lines']) ? $_GET['lines'] : '100';
    
    if ($lines === 'all') {
        $logContent = file_get_contents($logFile);
    } else {
        $lineCount = intval($lines);
        if ($lineCount <= 0) $lineCount = 100;
        
        // Use tail command to get last N lines efficiently
        $logContent = shell_exec("tail -n $lineCount " . escapeshellarg($logFile));
        
        if ($logContent === null || $logContent === false) {
            $logContent = file_get_contents($logFile);
        }
    }
    
    return json(array(
        'status' => 'OK',
        'log' => $logContent ?: '',
        'lines' => $lines
    ));
}

function fppBackgroundMusicDownloadLog() {
    $logFile = '/home/fpp/media/logs/fpp-plugin-BackgroundMusic.log';
    
    if (!file_exists($logFile)) {
        header('HTTP/1.1 404 Not Found');
        echo 'Log file not found';
        exit;
    }
    
    // Set headers for download
    header('Content-Type: text/plain');
    header('Content-Disposition: attachment; filename="backgroundmusic-' . date('Y-m-d_H-i-s') . '.log"');
    header('Content-Length: ' . filesize($logFile));
    
    readfile($logFile);
    exit;
}

// Helper function to fetch FPP setting value
function getFPPSettingValue($settingName) {
    $url = "http://127.0.0.1/api/settings/" . urlencode($settingName);
    $value = @file_get_contents($url);
    if ($value === false || $value === '') {
        return null;
    }
    // API returns JSON-encoded value, so decode it
    $decoded = json_decode($value, true); // Decode as array for easier handling
    
    // If it's an array with a 'value' key (standard FPP setting format), return just the value
    if (is_array($decoded) && isset($decoded['value'])) {
        // If the value itself is an array or object, convert to string representation
        if (is_array($decoded['value']) || is_object($decoded['value'])) {
            return json_encode($decoded['value']);
        }
        return $decoded['value'];
    }
    
    // If it's an object or array without a value key, convert to JSON string representation
    if (is_object($decoded) || is_array($decoded)) {
        return json_encode($decoded);
    }
    
    return $decoded !== null ? $decoded : $value;
}

function fppBackgroundMusicSystemDiagnostics() {
    global $settings;
    $pluginName = "fpp-plugin-BackgroundMusic";
    $pluginConfigFile = $settings['configDirectory'] . "/plugin." . $pluginName;
    
    try {
        $diagnostics = "=== BACKGROUND MUSIC PLUGIN - SYSTEM DIAGNOSTICS ===\n";
        $diagnostics .= "Generated: " . date('Y-m-d H:i:s T') . "\n\n";
        
        // Get system info from FPP API
        $systemInfoJson = @file_get_contents('http://127.0.0.1/api/system/info');
        $systemInfo = array();
        if ($systemInfoJson !== false) {
            $systemInfo = json_decode($systemInfoJson, true);
            if (!is_array($systemInfo)) {
                $systemInfo = array();
            }
        }
        
        // === FPP CORE INFORMATION ===
        $diagnostics .= "--- FPP CORE INFORMATION ---\n";
        
        // FPP Version from system info
        $fppVersion = $systemInfo['Version'] ?? 'Unknown';
        $diagnostics .= "FPP Version: " . $fppVersion . "\n";
        
        // FPP Branch from system info
        $fppBranch = $systemInfo['Branch'] ?? 'Unknown';
        $diagnostics .= "FPP Branch: " . $fppBranch . "\n";
        
        // OS Version
        $osVersion = $systemInfo['OSVersion'] ?? 'Unknown';
        $diagnostics .= "OS Version: " . $osVersion . "\n";
        
        // Platform/Hardware from system info
        $platform = $systemInfo['Platform'] ?? 'Unknown';
        $diagnostics .= "Platform: " . $platform . "\n";
        
        // Variant
        $variant = $systemInfo['Variant'] ?? '';
        if ($variant) {
            $diagnostics .= "Variant: " . $variant . "\n";
        }
        
        // SubPlatform (Hardware model)
        $subPlatform = $systemInfo['SubPlatform'] ?? exec("cat /proc/device-tree/model 2>/dev/null | tr -d '\\0' || echo 'Unknown'");
        $diagnostics .= "Hardware Model: " . $subPlatform . "\n";
        
        // OS Release Information
        $osRelease = $systemInfo['OSRelease'] ?? exec("cat /etc/os-release | grep PRETTY_NAME | cut -d= -f2 | tr -d '\"' 2>/dev/null || echo 'Unknown'");
        $diagnostics .= "Operating System: " . $osRelease . "\n";
        
        // Kernel Version
        $kernel = exec("uname -r 2>/dev/null || echo 'Unknown'");
        $diagnostics .= "Kernel Version: " . $kernel . "\n";
        
        $diagnostics .= "\n--- FPP SETTINGS ---\n";
        
        // Audio Output Settings
        $audioOutput = getFPPSettingValue('AudioOutput');
        $diagnostics .= "Audio Output: " . ($audioOutput !== null && $audioOutput !== '' && $audioOutput !== '[]' ? $audioOutput : 'Not Set') . "\n";
        
        $audioCard = getFPPSettingValue('AudioCard');
        $diagnostics .= "Audio Card: " . ($audioCard !== null && $audioCard !== '' && $audioCard !== '[]' ? $audioCard : 'Not Set') . "\n";
        
        // Volume Settings
        $volume = getFPPSettingValue('volume');
        $diagnostics .= "System Volume: " . ($volume !== null && $volume !== '' ? $volume : 'Not Set') . "\n";
        
        $audioMixerDevice = getFPPSettingValue('AudioMixerDevice');
        $diagnostics .= "Audio Mixer Device: " . ($audioMixerDevice !== null && $audioMixerDevice !== '' && $audioMixerDevice !== '[]' ? $audioMixerDevice : 'Not Set') . "\n";
        
        // Boot Delay
        $bootDelay = getFPPSettingValue('bootDelay');
        $diagnostics .= "Boot Delay: " . ($bootDelay !== null ? $bootDelay : '0') . " seconds\n";
        
        // Timezone
        $timezone = getFPPSettingValue('TimeZone');
        $diagnostics .= "Timezone: " . ($timezone !== null && $timezone !== '' ? $timezone : 'Not Set') . "\n";
        
        // Host name
        $hostname = getFPPSettingValue('HostName');
        $diagnostics .= "Hostname: " . ($hostname !== null && $hostname !== '' ? $hostname : exec("hostname")) . "\n";
        
        // FPP Mode (Player/Remote)
        $fppMode = getFPPSettingValue('fppMode');
        $diagnostics .= "FPP Mode: " . ($fppMode !== null && $fppMode !== '' ? $fppMode : 'Unknown') . "\n";
        
        // Multisync Settings
        $multisyncEnabled = getFPPSettingValue('MultiSyncEnabled');
        $diagnostics .= "MultiSync Enabled: " . ($multisyncEnabled == '1' ? 'Yes' : 'No') . "\n";
        
        if ($multisyncEnabled == '1') {
            $multisyncInterface = getFPPSettingValue('MultiSyncInterface');
            $diagnostics .= "MultiSync Interface: " . ($multisyncInterface !== null && $multisyncInterface !== '' && $multisyncInterface !== '[]' ? $multisyncInterface : 'Not Set') . "\n";
        }
        
        // Current Brightness
        $brightness = getFPPSettingValue('brightness');
        $diagnostics .= "Current Brightness: " . ($brightness !== null && $brightness !== '' && $brightness !== '[]' ? $brightness : '100') . "%\n";
    
    // === PLUGIN INFORMATION ===
    $diagnostics .= "\n--- BACKGROUND MUSIC PLUGIN INFORMATION ---\n";
    
    // Plugin Version from pluginInfo.json
    $pluginInfoFile = '/home/fpp/media/plugins/fpp-plugin-BackgroundMusic/pluginInfo.json';
    if (file_exists($pluginInfoFile)) {
        $pluginInfo = json_decode(file_get_contents($pluginInfoFile), true);
        if ($pluginInfo) {
            $diagnostics .= "Plugin Name: " . ($pluginInfo['name'] ?? 'Unknown') . "\n";
            $diagnostics .= "Plugin Version: " . ($pluginInfo['version'] ?? 'Unknown') . "\n";
            $diagnostics .= "Plugin Author: " . ($pluginInfo['author'] ?? 'Unknown') . "\n";
        }
    }
    
    // Git commit info
    $gitHash = exec("cd /home/fpp/media/plugins/fpp-plugin-BackgroundMusic && git rev-parse HEAD 2>/dev/null | cut -c1-7 || echo 'Unknown'");
    $diagnostics .= "Git Commit: " . $gitHash . "\n";
    
    $gitBranch = exec("cd /home/fpp/media/plugins/fpp-plugin-BackgroundMusic && git rev-parse --abbrev-ref HEAD 2>/dev/null || echo 'Unknown'");
    $diagnostics .= "Git Branch: " . $gitBranch . "\n";
    
    // === PLUGIN CONFIGURATION ===
    $diagnostics .= "\n--- PLUGIN CONFIGURATION ---\n";
    
    $pluginSettings = array();
    if (file_exists($pluginConfigFile)) {
        $pluginSettings = @parse_ini_file($pluginConfigFile);
        if ($pluginSettings === false) {
            $pluginSettings = array();
        }
    }
    
    $backgroundMusicPlaylist = $pluginSettings['BackgroundMusicPlaylist'] ?? 'Not Set';
    $diagnostics .= "Background Music Playlist: " . $backgroundMusicPlaylist . "\n";
    
    $backgroundMusicMode = $pluginSettings['BackgroundMusicMode'] ?? 'playlist';
    $diagnostics .= "Background Music Mode: " . $backgroundMusicMode . "\n";
    
    if ($backgroundMusicMode === 'stream') {
        $streamURL = $pluginSettings['StreamURL'] ?? 'Not Set';
        $diagnostics .= "Stream URL: " . $streamURL . "\n";
        
        $streamPreset = $pluginSettings['StreamPreset'] ?? 'None';
        $diagnostics .= "Stream Preset: " . $streamPreset . "\n";
    }
    
    $showPlaylist = $pluginSettings['ShowPlaylist'] ?? 'Not Set';
    $diagnostics .= "Main Show Playlist: " . $showPlaylist . "\n";
    
    $fadeTime = $pluginSettings['FadeTime'] ?? '5';
    $diagnostics .= "Fade Time: " . $fadeTime . " seconds\n";
    
    $blackoutTime = $pluginSettings['BlackoutTime'] ?? '2';
    $diagnostics .= "Blackout Time: " . $blackoutTime . " seconds\n";
    
    $returnToPreShow = $pluginSettings['ReturnToPreShow'] ?? '1';
    $diagnostics .= "Return to Pre-Show: " . ($returnToPreShow == '1' ? 'Enabled' : 'Disabled') . "\n";
    
    $shuffleMusic = $pluginSettings['ShuffleMusic'] ?? '0';
    $diagnostics .= "Shuffle Music: " . ($shuffleMusic == '1' ? 'Enabled' : 'Disabled') . "\n";
    
    $volumeLevel = $pluginSettings['VolumeLevel'] ?? '70';
    $diagnostics .= "Background Music Volume: " . $volumeLevel . "%\n";
    
    $backgroundMusicVolume = $pluginSettings['BackgroundMusicVolume'] ?? $volumeLevel;
    $diagnostics .= "Pre-Show Background Volume: " . $backgroundMusicVolume . "%\n";
    
    $showPlaylistVolume = $pluginSettings['ShowPlaylistVolume'] ?? '100';
    $diagnostics .= "Show Playlist Volume: " . $showPlaylistVolume . "%\n";
    
    $postShowBackgroundVolume = $pluginSettings['PostShowBackgroundVolume'] ?? $backgroundMusicVolume;
    $diagnostics .= "Post-Show Background Volume: " . $postShowBackgroundVolume . "%\n";
    
    // Crossfade settings
    $enableCrossfade = $pluginSettings['EnableCrossfade'] ?? '0';
    $diagnostics .= "Crossfade Enabled: " . ($enableCrossfade == '1' ? 'Yes' : 'No') . "\n";
    
    if ($enableCrossfade == '1') {
        $crossfadeDuration = $pluginSettings['CrossfadeDuration'] ?? '3';
        $diagnostics .= "Crossfade Duration: " . $crossfadeDuration . " seconds\n";
    }
    
    // PSA Settings
    $diagnostics .= "\n--- PSA SYSTEM SETTINGS ---\n";
    
    $enablePSA = $pluginSettings['EnablePSA'] ?? '1';
    $diagnostics .= "PSA System Enabled: " . ($enablePSA == '1' ? 'Yes' : 'No') . "\n";
    
    $psaDuckVolume = $pluginSettings['PSADuckVolume'] ?? '30';
    $diagnostics .= "PSA Duck Volume: " . $psaDuckVolume . "%\n";
    
    $psaButtonCount = 0;
    for ($i = 1; $i <= 20; $i++) {
        $buttonLabel = $pluginSettings["PSAButton{$i}Label"] ?? '';
        if (!empty($buttonLabel)) {
            $psaButtonCount++;
        }
    }
    $diagnostics .= "Configured PSA Buttons: " . $psaButtonCount . "/20\n";
    
    // TTS Settings
    $ttsEngine = $pluginSettings['TTSEngine'] ?? 'piper';
    $diagnostics .= "TTS Engine: " . ucfirst($ttsEngine) . "\n";
    
    if ($ttsEngine === 'elevenlabs') {
        $elevenLabsApiKey = $pluginSettings['ElevenLabsAPIKey'] ?? '';
        $diagnostics .= "ElevenLabs API Key: " . (!empty($elevenLabsApiKey) ? 'Configured' : 'Not Set') . "\n";
    }
    
    // === SYSTEM STATUS ===
    $diagnostics .= "\n--- SYSTEM STATUS ---\n";
    
    // FPP Status
    $status = GetCurrentStatus();
    $fppStatus = $status['status_name'] ?? 'unknown';
    $diagnostics .= "FPP Status: " . $fppStatus . "\n";
    
    $currentPlaylist = $status['current_playlist']['playlist'] ?? 'None';
    $diagnostics .= "Current Playlist: " . $currentPlaylist . "\n";
    
    $currentSequence = $status['current_sequence'] ?? 'None';
    $diagnostics .= "Current Sequence: " . $currentSequence . "\n";
    
    // Background music player status
    $pidFile = '/tmp/background_music_player.pid';
    $bgmRunning = false;
    if (file_exists($pidFile)) {
        $pid = trim(file_get_contents($pidFile));
        if (file_exists("/proc/$pid")) {
            $bgmRunning = true;
        }
    }
    $diagnostics .= "Background Music Player: " . ($bgmRunning ? 'Running' : 'Not Running') . "\n";
    
    // === SYSTEM RESOURCES ===
    $diagnostics .= "\n--- SYSTEM RESOURCES ---\n";
    
    // Disk usage
    $diskUsage = exec("df -h / | tail -1 | awk '{print $5}'");
    $diagnostics .= "Root Disk Usage: " . $diskUsage . "\n";
    
    $mediaDiskUsage = exec("df -h /home/fpp/media | tail -1 | awk '{print $5}'");
    $diagnostics .= "Media Disk Usage: " . $mediaDiskUsage . "\n";
    
    // Memory usage
    $memInfo = exec("free -h | grep Mem | awk '{print $3 \"/\" $2}'");
    $diagnostics .= "Memory Usage: " . $memInfo . "\n";
    
    // CPU Load
    $loadAvg = exec("cat /proc/loadavg | awk '{print $1, $2, $3}'");
    $diagnostics .= "CPU Load (1/5/15 min): " . $loadAvg . "\n";
    
    // Uptime
    $uptime = exec("uptime -p 2>/dev/null || uptime | awk '{print $3, $4}'");
    $diagnostics .= "System Uptime: " . $uptime . "\n";
    
    // === INSTALLED PLUGINS ===
    $diagnostics .= "\n--- KEY INSTALLED PLUGINS ---\n";
    
    // Check for brightness plugin
    $brightnessPluginPath = '/home/fpp/media/plugins/fpp-brightness';
    if (is_dir($brightnessPluginPath)) {
        $diagnostics .= "fpp-brightness: Installed\n";
        $brightnessVersion = exec("cd $brightnessPluginPath && git describe --tags 2>/dev/null || git rev-parse --short HEAD 2>/dev/null || echo 'Unknown'");
        $diagnostics .= "  Version: " . $brightnessVersion . "\n";
    } else {
        $diagnostics .= "fpp-brightness: NOT INSTALLED (Required for MultiSync fade transitions)\n";
    }
    
    // === NETWORK INFORMATION ===
    $diagnostics .= "\n--- NETWORK INFORMATION ---\n";
    
    // IP Address
    $ipAddress = exec("hostname -I | awk '{print $1}'");
    $diagnostics .= "IP Address: " . $ipAddress . "\n";
    
    // Network interfaces
    $interfaces = exec("ip -o link show | awk -F': ' '{print $2}' | grep -v lo | tr '\\n' ', ' | sed 's/,$//'");
    $diagnostics .= "Network Interfaces: " . $interfaces . "\n";
    
    // === AUDIO SYSTEM ===
    $diagnostics .= "\n--- AUDIO SYSTEM DETAILS ---\n";
    
    // ALSA cards
    $alsaCards = shell_exec("cat /proc/asound/cards 2>/dev/null || echo 'No ALSA cards found'");
    $diagnostics .= "ALSA Sound Cards:\n" . trim($alsaCards) . "\n";
    
    // Check if PipeWire is running
    $pipewireRunning = exec("pidof pipewire >/dev/null && echo 'Yes' || echo 'No'");
    $diagnostics .= "\nPipeWire Running: " . $pipewireRunning . "\n";
    
    // === RECENT LOG ENTRIES ===
    $diagnostics .= "\n--- RECENT LOG ENTRIES (Last 20 lines) ---\n";
    $logFile = '/home/fpp/media/logs/fpp-plugin-BackgroundMusic.log';
    if (file_exists($logFile)) {
        $recentLog = shell_exec("tail -n 20 " . escapeshellarg($logFile) . " 2>/dev/null || echo 'Could not read log file'");
        $diagnostics .= trim($recentLog) . "\n";
    } else {
        $diagnostics .= "Log file not found\n";
    }
    
    $diagnostics .= "\n=== END OF DIAGNOSTICS ===\n";
    
    return json(array(
        'status' => 'OK',
        'diagnostics' => $diagnostics
    ));
    
    } catch (Exception $e) {
        return json(array(
            'status' => 'ERROR',
            'message' => 'Error generating diagnostics: ' . $e->getMessage()
        ));
    }
}

?>