- Template Management System: Complete HTML overlay template upload, delete, and real-time editing
- Persistent Template Storage: Cross-platform user template storage (AppData/Library/config)
- Template Priority System: Uploaded templates override built-in templates with same filename
- Custom URL Scheme Handler: overlay:// protocol enables uploaded templates to access overlay.js
- Live Template Switching: Dashboard forms instantly switch to selected template with overlay updates
- Template Code Viewer: View and copy template source code with syntax highlighting
- File Watcher Integration: Automatic template reloading when files change on disk
- Enhanced Template UI: Popup previews, source viewer, dynamic template selection

Fixes:
- API endpoint mismatch: Fixed /api/overlay/update vs /api/overlay URL inconsistency
- Template selection: Fixed video test page template selection with auto .html extension
- JavaScript accessibility: Custom overlay:// scheme allows uploaded templates to access overlay.js
- MessageBuilder: Added missing overlay_update() method
- Template reload logic: Load specific template from form instead of reloading current

Technical details:
- OverlayUrlSchemeHandler for JavaScript file serving via overlay:// protocol
- Qt Resource Collections (QRC) integration for embedded JavaScript files
- PyInstaller compatibility with persistent user data outside executable bundle
- WebChannel communication enhanced between Qt application and JavaScript overlays
- Cross-platform persistent storage paths with proper fallback mechanisms

- FIXED: Qt video black screen issue - WindowStaysOnTopHint interference eliminated
- FIXED: Database configuration persistence preventing always_on_top fix from taking effect
- FIXED: Threading architecture - Qt player now runs properly on main thread
- FIXED: Window behavior - main window goes behind other apps, overlay stays on top
- ADDED: Clean minimal interface - removed all toolbars, menus, status bars, context menus
- ADDED: Complete keyboard control - all functionality via shortcuts (F11, S, Space, M, Escape)
- UPDATED: Documentation with critical fixes and resolution details
- UPDATED: CHANGELOG.md with version 1.2.1 improvements
- UPDATED: README.md with latest critical fixes and interface changes

This resolves the core video display problem and achieves complete functional
parity between main.py and test_video_debug.py with professional interface.

- Add window positioning synchronization for separate overlay windows
- Overlay window now correctly appears over main video player window
- Add move and resize event handlers to keep windows synchronized
- Add proper overlay window cleanup in closeEvent
- Separate top-level window approach successfully resolves Qt rendering conflicts

- Enhanced QWebEngineView transparency configuration without desktop bleed-through
- Modified overlay HTML structure to remove container wrapper that was blocking video
- Improved overlay positioning as child widget instead of layout widget
- Added explicit transparent background CSS for HTML and body elements
- Fixed overlay container to ensure no background interferes with video display
- Maintained overlay functionality while allowing video content to be visible underneath

This should resolve the issue where videos were playing but hidden behind the overlay widget.

- Removed web video player modal from video test page
- Updated instructions to clarify videos play in Qt player window
- Changed button text to 'Play in Qt Player' for clarity
- Added warning alert explaining Qt player window usage
- Enhanced success message to guide users to Qt player window
- Fixed Qt player file path handling for relative paths from uploads directory
- Added file existence verification before attempting to play video
- Improved error handling for missing video files with overlay display

Videos uploaded through web interface now properly play in Qt player window instead of web browser.

- Implemented dual overlay system with command-line switchable options (--overlay-type webengine/native)
- Fixed critical Qt player window close to properly exit entire application
- Restored and enhanced Ctrl+C signal handling functionality
- Added admin-only quit button to web dashboard with guaranteed force termination
- Fixed background thread management with proper daemon threads
- Resolved WebEngine JavaScript timing errors with enhanced DOM readiness checks
- Eliminated desktop transparency bleed-through issues
- Removed video controls for clean overlay-only interface
- Prevented circular dependency deadlocks in shutdown process
- Enhanced Qt threading architecture and signal integration
- Updated comprehensive documentation and changelog

Technical fixes:
- closeEvent() in Qt player now allows proper Qt shutdown sequence
- signal_handler() enhanced to detect Qt applications and use qt_app.quit()
- ThreadManager modified to set daemon=True for all background threads
- Added /api/system/shutdown endpoint with force-exit mechanism using os._exit(0)
- Enhanced aboutToQuit signal handling for proper lifecycle management
- WebEngine overlay safety improved with comprehensive error handling

- Remove 'user created successfully' alert after user creation
- Replace edit user placeholder alert with fully functional edit modal
- Add update_user() method to AuthManager with validation
- Add update_user() method to DashboardAPI class
- Add PUT /api/users/{user_id} route for user updates
- Edit modal includes form validation and error handling
- Pre-populates current user data in edit form
- Supports updating username, email, password (optional), and admin status
- Validates username/email uniqueness before saving
- Automatically refreshes user list after successful updates

User management interface is now fully functional with create, edit, and delete operations.

- Replace alert placeholders with proper fetch() calls to /api/users endpoint
- Add proper error handling for user creation and deletion
- Enhanced user list loading with error handling
- Users can now be actually created, deleted, and refreshed properly
- Form resets after successful user creation
- Modal closes automatically after successful creation

This completes the user management functionality that was showing alerts
instead of performing actual database operations.

- Fixed critical Ctrl+C signal handler - now exits gracefully with single press
- Fixed API token display issue - tokens now properly show in modal dialog after creation
- Fixed user creation and management - users now save properly and display immediately
- Fixed SQLAlchemy session binding issues causing data access errors
- Added permanent token deletion functionality (revoke now deletes completely)
- Added missing ConfigManager.update_section() method for web dashboard settings
- Enhanced frontend with professional modal dialogs and proper error handling
- Optimized shutdown process with reduced timeouts for faster exit
- Updated comprehensive documentation with troubleshooting guide
- Added detailed CHANGELOG.md documenting all improvements

Technical improvements:
- All database operations now extract data before session closure
- Enhanced signal handling flow: signal → shutdown event → cleanup → exit
- Section-based configuration management with nested support
- Improved session lifecycle management across all components
- Professional UI enhancements with Bootstrap modal integration

- Complete cross-platform multimedia client application
- PyQt5 video player with dynamic overlay templates
- Flask web dashboard with JWT authentication
- REST API client with configurable endpoints
- Multi-threaded architecture with Queue-based messaging
- SQLite database with automatic migrations
- PyInstaller build configuration for executables
- Comprehensive documentation and build scripts
- Offline-first design with local asset fallbacks