VideoTools/TODO.md

VT Player TODO

This file tracks upcoming features, improvements, and known issues for the GTK/MPV-based dual-pane video player.

Current Focus: GTK Player with MPV

High Priority Features

Playback Controls

• Add seek bar/slider for timeline scrubbing
• Add current time / duration display
• Add playback speed control (0.25x, 0.5x, 1x, 2x, etc.)
• Add volume controls (currently no UI for volume)
• Add mute toggle button
• Add fullscreen mode toggle
• Keyboard shortcuts for playback control
  • Space: Play/Pause
  • Left/Right arrows: Seek backward/forward
  • Up/Down arrows: Volume
  • F: Fullscreen
  • 0: Seek to start
  • , and .: Frame step backward/forward

Video Management

• Add "Clear Left" and "Clear Right" buttons
• Add video swap button (swap left and right panes)
• Add playlist panel showing loaded videos
• Add "Remove from playlist" option
• Save/load playlist functionality
• Remember last loaded videos on startup

Drag & Drop Improvements

• Show visual feedback during drag hover
• Support dropping onto specific pane (left or right)
• Support dropping video onto empty space to open file dialog
• Handle multiple files dropped simultaneously (load into queue)

Sync Features

• Add sync lock toggle (when enabled, both videos seek/play together)
• Add offset adjustment (sync videos with time offset)
• Visual indicator when videos are synced
• Smart sync based on similar durations

Display & Layout

• Add video zoom controls (fit, fill, actual size)
• Add aspect ratio override options
• Add grid overlay option for alignment checking
• Add split position slider (adjust left/right pane sizes)
• Add vertical split mode option
• Add single-pane mode (hide one side)
• Dark theme refinements and color scheme options

File Information

• Show more video metadata in info label
  • Codec details
  • Bitrate
  • File size
  • Frame rate
• Add tooltip on hover showing full file path
• Add metadata panel (collapsible)

Medium Priority Features

Export & Comparison

• Screenshot capture for current frame (both panes or individual)
• Export comparison frame (side-by-side screenshot)
• Export difference map (visual difference between frames)
• Frame-by-frame comparison mode with metrics (SSIM, PSNR)

Performance

• Hardware decoding options (VA-API, VDPAU, NVDEC)
• Configurable preview quality (for smoother playback on slower systems)
• Memory usage optimization for long videos
• Cache recently viewed frames

Settings & Configuration

• Settings dialog
  • Default window size
  • Default playback behavior (auto-pause on load, etc.)
  • Hardware acceleration preferences
  • Preview thumbnail settings
  • Auto-sync settings
• Save/restore window position and size
• Remember last used pane assignments

Audio

• Audio track selection (for multi-track videos)
• Audio visualization (waveform or spectrum)
• Audio sync offset adjustment
• Independent audio muting per pane

Low Priority / Future Features

Advanced Playback

• A-B loop (repeat between two points)
• Slow-motion playback with frame interpolation
• Chapter support (if video has chapters)
• Bookmark/marker system for quick navigation

Video Analysis

• Histogram display
• Vectorscope display
• Waveform monitor
• Scopes in separate window or overlay

Filters & Effects

• Real-time color adjustment (brightness, contrast, saturation)
• Deinterlacing toggle
• Rotate/flip controls
• Crop preview

Batch Operations

• Batch screenshot export (every N frames)
• Batch comparison report generation
• Export comparison video (both videos side-by-side in single file)

File Management

• Recent files list
• Favorite files/folders
• File browser panel
• Watch folder (auto-load new videos from folder)

Collaboration Features

• Export playback session (timestamps, notes)
• Import playback session
• Notes/comments system with timestamps
• Export comparison report (PDF/HTML)

Technical Debt & Improvements

Code Quality

• Add unit tests for core functionality
• Add integration tests for mpv wrapper
• Improve error handling and user feedback
• Add comprehensive logging system
• Refactor main.go into multiple files/packages
  • Split UI code from logic
  • Separate pane management
  • Separate playlist management
  • Separate mpv wrapper improvements

Build & Distribution

• Create proper installation script
• Create .desktop file for Linux
• Add to Linux app stores (Flathub, Snap Store)
• Package as AppImage
• Create .deb and .rpm packages
• Test on different Linux distributions
• Test on different desktop environments (GNOME, KDE, XFCE)

Documentation

• User guide with screenshots
• Keyboard shortcuts reference card
• Video tutorial (getting started)
• Contributing guide
• Architecture documentation
• API documentation for mpvembed package

Platform Support

• Test Wayland compatibility (currently uses X11)
• Test on macOS (via XQuartz)
• Windows support evaluation
  • Test GTK3 on Windows
  • Test MPV embedding on Windows
  • Create Windows installer

Known Issues

Critical

• None currently

Minor

• No visual feedback when drag-and-drop is active
• Window title doesn't update with loaded video names
• No warning when closing with videos loaded
• Metadata display truncates long filenames

Enhancement Needed

• Better error messages when MPV fails to load video
• Improve startup time for large video files
• Add progress indicator for video loading
• Better handling of unsupported video formats

Research & Investigation

• Investigate MPV render API for better integration
• Research best practices for video sync across players
• Explore frame-accurate seeking optimizations
• Investigate color management and HDR support
• Research subtitle rendering options
• Evaluate audio normalization for comparison mode

Completed (See DONE.md)

• ✅ Basic GTK player with MPV embedding
• ✅ Dual-pane layout with independent playback
• ✅ Drag-and-drop file loading
• ✅ Basic playback controls (play, pause, seek, frame step)
• ✅ Video playlist tracking with IDs
• ✅ Metadata display (resolution, duration, position)
• ✅ CGO/MPV render context implementation

---

Last Updated: 2025-12-15