Releases

Track MVidarr’s development progress through our release history and upcoming milestones.

🚀 Current Release: v0.9.8

Released: October 7, 2025 Focus: Subtitle System, User Testing Fixes & FastAPI Migration Completion

🎉 Major Achievements

Complete Subtitle System ✅

  • 🎬 Universal Subtitle Support: WebVTT, SRT, ASS, SSA, SUB formats fully supported
  • 🌐 Smart Language Resolution: Automatic YouTube non-standard language code handling (en.* → en-nP7-2PuUl7o)
  • 🎞️ Player Integration: Subtitles working in popup modal and detail page video players
  • 📡 FastAPI Endpoints: Complete subtitle discovery and serving API with CORS support
  • ⚙️ Settings Respect: Database-driven subtitle language preferences honored
  • 🎯 Auto-Enable: First subtitle track automatically loaded and displayed

User Testing Fixes (8/8 Critical Issues Resolved) ✅

  • ✅ Authentication System: Fixed logout redirect, search functionality, video deletion
  • ✅ Bulk Operations: Restored bulk operations with proper error handling and progress tracking
  • ✅ Playlist System: Fixed playlist page loading (1,700+ line JavaScript) and creation functionality
  • ✅ Toast Notifications: Fixed notification system across all user workflows
  • ✅ Service Integration: Corrected routing for YouTube Playlists, Spotify, Last.fm, Lidarr pages
  • ✅ Artist Management: Fixed artist import from IMVDb with proper error messages
  • ✅ Video Management: Resolved foreign key constraint issues in video deletion
  • ✅ Search System: Restored search suggestions endpoint with authentication

100% Flask to FastAPI Migration Complete ✅

  • ⚡ 200+ API Endpoints: Migrated across 33 major components with full async support
  • 🔧 17 FastAPI Routers: Created with comprehensive Pydantic validation
  • 🛡️ Consistent Authentication: Session-based auth across all endpoints
  • 🚀 Performance: Native async/await support throughout application
  • ✨ Pure FastAPI: Zero Flask API endpoints remain

Key Features

Service Integration

  • 📹 YouTube Playlists: 12 endpoints with monitoring and sync capabilities
  • 🎶 Spotify Integration: 25+ endpoints with OAuth flow (callback endpoint complete)
  • 🎭 IMVDb Discovery: 20+ endpoints for video discovery and analytics
  • 📺 Plex Sync: 15+ endpoints for library synchronization
  • 🎧 Lidarr Integration: 5 endpoints for music library sync
  • 🔔 Webhooks: Event-driven notification system

Enhanced Features

  • 🎯 Enhanced Artist Discovery: Multi-source search across IMVDb and YouTube
  • ⏰ Advanced Scheduler: Task control with exponential/linear/fixed retry strategies
  • 📁 Video Organization: Automatic folder creation and intelligent file management
  • 🔒 Security: Certificate management and session-based authentication
  • ⚙️ System Optimization: 9 endpoints for performance and health monitoring

Technical Enhancements

  • FastAPI Async Architecture: Complete migration with performance improvements
  • Advanced Job Queue: Background job dependency management and WebSocket progress updates
  • Comprehensive Testing: 40+ Playwright tests across authentication, API, and UI validation
  • CI/CD Integration: Automated testing with multi-browser support and GitHub Actions
  • Database Migrations: 6 built-in themes (Cyber, Default, VaporWave, TARDIS, Punk 77, MTV)

Critical Bug Fixes

  • Fixed blacklist loading TypeError and API response structure mismatches
  • Fixed playlist page JavaScript loading with proper url_for syntax
  • Fixed MKV video playback with correct MIME type detection
  • Fixed OAuth2 status JavaScript errors in settings page
  • Fixed YouTube Playlists route pattern mismatches with aliases
  • Added missing enhanced-refresh-all-metadata FastAPI endpoint
  • Fixed migration 015 to use admin user ID dynamically

Known Issues & Limitations

Based on comprehensive user testing (24 issues tracked):

  • 🔍 11 Issues Require Investigation: Service integration testing, background job monitoring, download quality settings
  • ⚠️ 1 Partially Resolved: Scan missing thumbnails (Flask endpoint exists, FastAPI needs adding)
  • 📋 2 Low Priority: UI/UX improvements and content cleanup

See USER_TESTING_RESULTS_0.9.8.md for complete testing results and SERVICE_INTEGRATION_API_STATUS.md for API migration status.

Documentation

  • Testing Plan: TESTING_PLAN_0.9.8.md - Systematic validation framework
  • Testing Results: USER_TESTING_RESULTS_0.9.8.md - Complete verification (42% issues resolved)
  • Cleanup Plan: MILESTONE_0.9.9_CLEANUP.md - Code optimization roadmap
  • API Status: SERVICE_INTEGRATION_API_STATUS.md - Complete migration documentation

Docker Image: ghcr.io/prefect421/mvidarr:v0.9.8 Status: ✅ READY FOR 0.9.9 CLEANUP PHASE

🔄 Development Version: v0.9.9-dev

Status: In Active Development
Focus: Enterprise Features & Multi-User Support

Planned Improvements

  • Advanced user management and role-based access control
  • Multi-tenant artist libraries and data isolation
  • Comprehensive audit logging and activity tracking
  • API rate limiting and resource quota management
  • Enhanced authentication integration (LDAP/SSO)

📅 Release Roadmap

v0.9.6 - Quality Assurance & Testing Infrastructure

Planned Release: November 2025

  • Comprehensive pytest test suite framework
  • Visual testing and screenshot automation
  • Log capture and error analysis system
  • CI/CD testing integration and automation
  • Test monitoring and maintenance infrastructure

v0.9.7 - Advanced Features & Integration

Planned Release: February 2026

  • Advanced video filtering and search system
  • Bulk operations and batch management system
  • Enhanced artist discovery and metadata enrichment
  • Import/export and backup management system
  • Custom video organization rules and automation

v0.9.9 - Enterprise & Multi-User Features

Planned Release: December 2025

  • Advanced user management and role-based access control
  • Multi-tenant artist libraries and data isolation
  • Comprehensive audit logging and activity tracking
  • API rate limiting and resource quota management
  • Enterprise authentication integration (LDAP/SSO/SAML)

v0.9.10 - External Service Integrations

Planned Release: March 2026

  • Enhanced Spotify integration and music discovery
  • Media server integration (Plex/Jellyfin/Emby)
  • Advanced notification system with Discord/Slack integration
  • Third-party metadata providers integration
  • Cloud storage integration and backup solutions

v0.10.0-beta.1 - First Beta Release (Current)

Release Date: December 1, 2025 Updated: December 2, 2025 Status: Beta Testing - Active Development SemVer: Following 0.x.y convention for pre-production software Docker Image: ghcr.io/prefect421/mvidarr:v0.10.0-beta.1

🔒 Security Enhancements

  • Critical Vulnerabilities Fixed (10): werkzeug, python-multipart, jinja2
  • DoS Vulnerability Patches: Fixed FastAPI/Starlette DoS vulnerabilities (PYSEC-2024-38, GHSA-f96h-pmfr-66vw, GHSA-7f5h-v6xp-fcq8)
  • Dependency Updates: All production dependencies updated to secure versions

🐛 Critical Bug Fixes

  • Chrome STATUS_BREAKPOINT Crash: Resolved Chrome browser crash when seeking videos with active subtitles
    • Implemented Chrome-specific workaround to disable subtitles during seek operations
    • Other browsers (Firefox, Safari, Edge) maintain normal subtitle functionality
    • See Browser Compatibility Guide for details
  • MariaDB Health Check: Updated Docker health check to use mariadb-admin instead of deprecated mysqladmin
  • Subtitle Stability: Enhanced subtitle track handling across all video players

📋 Versioning & Code Quality

  • SemVer Migration: Adopted SemVer 0.x.y convention for pre-production clarity
  • Code Cleanup: 71.4% size reduction from systematic refactoring
  • Version Metadata: Enhanced version tracking with commit hash and build timestamps

🔧 New Features

  • Installation Wizard: Guided first-run setup with validation
  • Video Import System: Reliable import with duplicate detection
  • API Validation: Pre-configuration testing capabilities
  • Performance Monitoring: Comprehensive system health dashboard
  • Browser Compatibility: Intelligent browser-specific behavior for optimal experience

🌐 Browser Support

  • Fully Supported: Firefox, Safari, Edge, Opera, Brave
  • Chrome: Supported with workarounds (see compatibility notes)
  • Recommended: Firefox or Edge for best subtitle experience during video seeking

📚 Documentation Updates

  • New: Browser Compatibility Guide with detailed browser-specific notes
  • Enhanced: CLAUDE.md with Chrome subtitle behavior documentation
  • Updated: Known issues section with browser compatibility information

🐳 Docker Improvements

  • Health Checks: Fixed MariaDB health check for better container reliability
  • Build Date: Version metadata now includes accurate build timestamps
  • Commit Tracking: Docker images tagged with git commit hash for traceability

Known Issues

  • Chrome Subtitle Seeking: Subtitles may need manual re-enable after seeking (stability workaround)
  • Safari WebM: Limited codec support (auto-transcoded to MP4)

Beta Status: This release is feature-complete but requires production testing and validation before v1.0.0.

Related Issues: #165 (Security Vulnerabilities), #163 (Installation Wizard), #91 (Documentation), #95 (Performance Monitoring)

Git Commit: 78fd56b Build: 2025-12-02

v1.0.0 - Pre-release (Superseded)

Release Date: November 25, 2025 Status: Development Milestone

Originally tagged as first production release, but re-classified as pre-release milestone. Development continues in 0.10.x-beta series.

Future: v1.0.0 - Production Readiness & Stability

Planned Release: November 2026 - Public Release

  • Complete documentation overhaul and user guides
  • Migration tools and database upgrade automation
  • Advanced backup and disaster recovery system
  • Production deployment automation and infrastructure
  • Long-term maintenance tools and system optimization

📈 Previous Releases

v0.9.4

Released: August 6, 2025
Focus: Docker Optimization and Build Reliability

  • Docker build optimization and reliability improvements
  • Container size reduction and performance enhancements
  • Build monitoring infrastructure and validation tools
  • Production-ready container configurations
  • Comprehensive Docker build automation

v0.9.3

Released: July 28, 2025
Focus: Security Implementation

  • Enterprise-grade security audit completion
  • Comprehensive vulnerability remediation (17 issues fixed)
  • Advanced security monitoring infrastructure
  • Automated security scanning workflows
  • Enhanced authentication and authorization systems

v0.9.2

Released: July 15, 2025
Focus: Core Functionality Stabilization

  • Advanced artist management system
  • Comprehensive video discovery and organization
  • Modern UI with theme system implementation
  • Database-driven configuration management
  • System health monitoring and diagnostics

v0.9.1

Released: June 2025
Focus: Foundation and Architecture

  • Initial Flask application architecture
  • Basic artist and video management
  • Database schema and ORM implementation
  • Authentication system foundation
  • Docker containerization setup

🔄 Release Process

Release Cycles

  • Major Releases (x.y.0): Every 3-4 months with significant new features
  • Minor Releases (x.y.z): Monthly with bug fixes and small improvements
  • Security Releases: As needed for critical security updates

Quality Assurance

  • Automated Testing: Comprehensive test suite with CI/CD integration
  • Security Scanning: Multi-tool security validation on every release
  • Performance Testing: Automated performance regression testing
  • Docker Validation: Container build and size optimization verification

Release Notes

Each release includes detailed notes covering:

  • New features and improvements
  • Security updates and fixes
  • Performance enhancements
  • Breaking changes and migration guides
  • Known issues and workarounds

📋 Release Statistics

Development Metrics

  • Total Releases: 4 major releases
  • Issues Resolved: 150+ across all releases
  • Security Fixes: 17 vulnerabilities addressed
  • Docker Optimization: 100% build reliability achieved
  • Test Coverage: 90%+ code coverage (target for v0.9.6)

Performance Improvements

  • Docker Build Time: From timeout failures to 8m6s consistent builds
  • Container Size: Optimized to 1.41GB production images
  • Security Posture: Zero known vulnerabilities maintained
  • API Response Times: <500ms for typical operations (target)
  • Database Performance: Optimized for 10,000+ video libraries

🎯 Version Support

Current Support Status

  • v0.9.4: ✅ Fully supported with security updates
  • v0.9.3: ✅ Security updates only
  • v0.9.2: ⚠️ End of life - upgrade recommended
  • v0.9.1: ❌ End of life - upgrade required

Support Policy

  • Latest Release: Full feature support and security updates
  • Previous Release: Security updates for 6 months
  • Older Releases: End of life after 1 year

📦 Download & Deployment

Docker Images

# Latest stable release
docker pull ghcr.io/prefect421/mvidarr:latest

# Specific version
docker pull ghcr.io/prefect421/mvidarr:v0.9.4

# Development build
docker pull ghcr.io/prefect421/mvidarr:dev

Source Code

# Latest release
git clone --branch v0.9.4 https://github.com/prefect421/mvidarr.git

# Development version
git clone --branch dev https://github.com/prefect421/mvidarr.git

Release Verification

All releases are:

  • Signed: GPG signatures for source releases
  • Checksummed: SHA256 checksums for all artifacts
  • Scanned: Security scanned before publication
  • Tested: Automated testing and validation

📢 Release Notifications

Stay updated on new releases:

Looking for a specific version? Check our complete release history on GitHub.