diff --git a/.gitignore b/.gitignore
index 41ca6e5..422af83 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,3 +30,4 @@ db/*.db
# OS files
.DS_Store
Thumbs.db
+cookies.txt
diff --git a/IMPLEMENTATION_SUMMARY.md b/IMPLEMENTATION_SUMMARY.md
new file mode 100644
index 0000000..2ff8f3f
--- /dev/null
+++ b/IMPLEMENTATION_SUMMARY.md
@@ -0,0 +1,249 @@
+# Implementation Summary: Flash Message Visibility & M3U8 Single-Stream Field
+
+## Overview
+This implementation addresses two key user experience improvements for the RetroIPTVGuide tuner management interface:
+1. Persistent flash messages that users can actually read
+2. Simplified single-stream M3U8 URL support
+
+## Changes Implemented
+
+### 1. Flash Message Visibility Enhancement
+
+#### Problem Solved
+Previously, flash messages (validation errors, success messages, warnings) would disappear too quickly for users to read them, especially on the change_tuner page where they weren't even displayed.
+
+#### Solution Implemented
+- **Flash message display added** to `templates/change_tuner.html`
+- **Sticky positioning** keeps messages visible while scrolling
+- **8-second persistence** with smooth fade-out animation
+- **Manual dismiss button** (×) for immediate closure
+- **Color-coded categories**: success (green), warning (yellow), error (red), info (blue)
+- **Theme support**: Proper contrast in both dark and light themes
+
+#### Code Structure
+```html
+
+
+
+ {{ message }}
+
+
+
Tuners
Switch the active tuner, edit tuner sources, and manage tuners. Dangerous actions are separated below to avoid accidental deletion.
+
+ {% with messages = get_flashed_messages(with_categories=true) %}
+ {% if messages %}
+
+ {% for category, message in messages %}
+
+ {{ message }}
+
+
+ {% endfor %}
+
Edit / Add Tuners
-
-
+
+
+
+
+
+
+
+
Standard mode requires both XML and M3U playlist URLs. Single stream mode is for a direct M3U8 stream URL.
+
+
+
-
-
+
+
+
+
+
+
+
+
+
Direct link to a single M3U8 stream. Channel name will be auto-generated from the tuner name.
+
Danger Zone — Delete Tuner
var sel = document.getElementById('tuner_update');
if (sel) populateUrls(sel.value);
+ // Flash message auto-dismiss and manual close
+ try {
+ const flashMessages = document.querySelectorAll('.flash-message');
+ if (flashMessages.length > 0) {
+ // Add close button handlers
+ flashMessages.forEach(msg => {
+ const closeBtn = msg.querySelector('.flash-close');
+ if (closeBtn) {
+ closeBtn.addEventListener('click', () => {
+ msg.classList.add('fade-out');
+ setTimeout(() => msg.remove(), 500);
+ });
+ }
+ });
+
+ // Auto-dismiss after 8 seconds
+ setTimeout(() => {
+ flashMessages.forEach(msg => {
+ if (msg.parentNode) { // Check if still in DOM
+ msg.classList.add('fade-out');
+ setTimeout(() => {
+ if (msg.parentNode) msg.remove();
+ }, 500);
+ }
+ });
+ }, 8000);
+ }
+ } catch (e) {
+ // Flash messages will remain visible if auto-dismiss fails
+ console.error('Flash message initialization failed:', e);
+ }
+
// Run Now (uses existing endpoint)
const runNow = document.getElementById('btn-run-now');
if (runNow) {
@@ -261,6 +333,50 @@ Danger Zone — Delete Tuner
selRename.value = selUpdate.value;
}
} catch (e) {}
+
+ // Mode switching for Add Tuner form
+ try {
+ const standardFields = document.getElementById('standard-fields');
+ const streamFields = document.getElementById('stream-fields');
+ const xmlInput = document.getElementById('xml_new');
+ const m3uInput = document.getElementById('m3u_new');
+ const m3u8Input = document.getElementById('m3u8_stream');
+ const modeRadios = document.querySelectorAll('input[name="tuner_mode"]');
+
+ function updateFormMode() {
+ const selectedMode = document.querySelector('input[name="tuner_mode"]:checked');
+ if (selectedMode && selectedMode.value === 'single_stream') {
+ // Single stream mode
+ standardFields.style.display = 'none';
+ streamFields.style.display = 'block';
+ // Remove required from standard fields
+ xmlInput.removeAttribute('required');
+ m3uInput.removeAttribute('required');
+ // Add required to stream field
+ m3u8Input.setAttribute('required', 'required');
+ } else {
+ // Standard mode
+ standardFields.style.display = 'block';
+ streamFields.style.display = 'none';
+ // Add required to standard fields
+ xmlInput.setAttribute('required', 'required');
+ m3uInput.setAttribute('required', 'required');
+ // Remove required from stream field
+ m3u8Input.removeAttribute('required');
+ }
+ }
+
+ // Initialize mode on load
+ updateFormMode();
+
+ // Handle mode change
+ modeRadios.forEach(radio => {
+ radio.addEventListener('change', updateFormMode);
+ });
+ } catch (e) {
+ // Log error if mode switching setup fails - form will still submit with default standard mode
+ console.error('Mode switching initialization failed:', e);
+ }
});
{% endblock %}
diff --git a/tests/test_single_stream_mode.py b/tests/test_single_stream_mode.py
new file mode 100644
index 0000000..1bbdce8
--- /dev/null
+++ b/tests/test_single_stream_mode.py
@@ -0,0 +1,97 @@
+"""Test cases for single-stream mode functionality"""
+import pytest
+import sys
+import os
+
+# Add parent directory to path to import app
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from app import app, init_db, init_tuners_db, add_tuner, get_tuners
+import tempfile
+import sqlite3
+
+
+class TestSingleStreamMode:
+ """Test single-stream mode functionality"""
+
+ @pytest.fixture(autouse=True)
+ def setup_teardown(self):
+ """Set up test database before each test and clean up after"""
+ # Create temporary database files
+ self.temp_db = tempfile.NamedTemporaryFile(delete=False, suffix='.db')
+ self.temp_tuner_db = tempfile.NamedTemporaryFile(delete=False, suffix='.db')
+
+ # Store original database paths
+ import app as app_module
+ self.orig_db = app_module.DATABASE
+ self.orig_tuner_db = app_module.TUNER_DB
+
+ # Set temporary database paths
+ app_module.DATABASE = self.temp_db.name
+ app_module.TUNER_DB = self.temp_tuner_db.name
+
+ # Initialize databases
+ init_db()
+ init_tuners_db()
+
+ yield
+
+ # Clean up
+ app_module.DATABASE = self.orig_db
+ app_module.TUNER_DB = self.orig_tuner_db
+ os.unlink(self.temp_db.name)
+ os.unlink(self.temp_tuner_db.name)
+
+ def test_add_single_stream_tuner(self):
+ """Test adding a tuner in single-stream mode"""
+ # Single stream mode uses the same URL for both XML and M3U
+ stream_url = "https://example.com/live/stream.m3u8"
+ tuner_name = "Test Single Stream"
+
+ # Add tuner with same URL for both fields (simulating single-stream mode)
+ add_tuner(tuner_name, stream_url, stream_url)
+
+ # Verify tuner was added correctly
+ tuners = get_tuners()
+ assert tuner_name in tuners
+ assert tuners[tuner_name]['xml'] == stream_url
+ assert tuners[tuner_name]['m3u'] == stream_url
+
+ def test_add_standard_mode_tuner(self):
+ """Test adding a tuner in standard mode"""
+ xml_url = "https://example.com/guide.xml"
+ m3u_url = "https://example.com/playlist.m3u"
+ tuner_name = "Test Standard"
+
+ # Add tuner with different URLs (standard mode)
+ add_tuner(tuner_name, xml_url, m3u_url)
+
+ # Verify tuner was added correctly
+ tuners = get_tuners()
+ assert tuner_name in tuners
+ assert tuners[tuner_name]['xml'] == xml_url
+ assert tuners[tuner_name]['m3u'] == m3u_url
+
+ def test_duplicate_tuner_name(self):
+ """Test that duplicate tuner names are rejected"""
+ tuner_name = "Duplicate Test"
+ url = "https://example.com/stream.m3u8"
+
+ # Add first tuner
+ add_tuner(tuner_name, url, url)
+
+ # Try to add duplicate - should raise ValueError
+ with pytest.raises(ValueError, match="already exists"):
+ add_tuner(tuner_name, url, url)
+
+ def test_empty_urls(self):
+ """Test that empty URLs are rejected"""
+ with pytest.raises(ValueError, match="cannot be empty"):
+ add_tuner("Test Tuner", "", "https://example.com/playlist.m3u")
+
+ with pytest.raises(ValueError, match="cannot be empty"):
+ add_tuner("Test Tuner", "https://example.com/guide.xml", "")
+
+
+if __name__ == '__main__':
+ pytest.main([__file__, '-v'])