Releases

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

🚀 Current Release: v0.11.9

Released: February 5, 2026 Focus: Security Updates, Video Quality & Discovery Fix

🎉 What’s New

Security Updates ✅ (11 CVEs Fixed)

Critical security vulnerabilities addressed through dependency updates:

Package Update CVE
python-multipart 0.0.20 → 0.0.22 CVE-2026-24486 (path traversal)
urllib3 2.6.0 → 2.6.3 CVE-2026-21441 (decompression-bomb bypass)
aiohttp 3.12.14 → 3.13.3 CVE-2025-69223/24/25/26/27/28/29/30 (zip bomb + DoS)
werkzeug 3.1.4 → 3.1.5 CVE-2026-21860 (Windows device names bypass)

Video Quality Fix ✅

  • Format Sorting: Added -S flag to prioritize resolution over bitrate
  • User Settings Respected: Downloads now honor max_video_quality database setting
  • TV Client Fallback: Falls back to web client for more format options
  • No More 360p: Videos now download at the quality you expect

YouTube Discovery Fix ✅

  • API Key Caching Bug: Fixed issue where empty API key was cached forever
  • Settings Updates Work: Changing YouTube API key in Settings now takes effect immediately
  • Cache Invalidation: Bumped cache version to clear stale empty results

Upgrade Notes

  • Docker image rebuild required for security updates
  • Restart required for discovery fix to take effect
  • Video downloads will now respect format sorting for better quality

Docker Image

docker pull ghcr.io/prefect421/mvidarr:v0.11.9
docker pull ghcr.io/prefect421/mvidarr:latest
Git Commit: 26511da Build: 2026-02-05

📈 Previous Release: v0.11.8

Released: February 4, 2026 Focus: Thumbnail System Overhaul

What’s New

  • Complete fix of artist thumbnail system (0% → 87% bulk scan success)
  • Manual thumbnail setting fixed with proper error display
  • Google Images priority for thumbnail search
  • Wikimedia 403/429 error handling with browser-like headers
  • Redis configuration environment variables (REDIS_HOST, REDIS_PORT)
Git Commit: f3d2c96 Build: 2026-02-04

📈 Previous Release: v0.11.7

Released: February 2, 2026 Focus: Video Filtering, Extended Video Discovery & Blacklist Fix

What’s New

Per-Artist Video Type Filtering ✅ (Issue #191)

  • Video Type Selection: Users can now specify which video types to download per artist
  • Supported Types: Official Video, Official Music Video, Live, Lyric Video, Lyrics, Other
  • Autodownload Integration: Filtering preferences respected during automatic video discovery
  • Flexible Configuration: Checkbox/multiselect options for granular control

Extended Video Discovery ✅

  • Live Performances: YouTube discovery now finds live performances, concerts, acoustic versions
  • Multi-Search Strategy: Bypasses YouTube Music category limitations for better results
  • Increased Discovery: Default max_videos_per_discovery increased from 5 to 50

API Optimization ✅

  • Performance Improvements: Optimized API endpoints for faster response times
  • Reduced Latency: Streamlined database queries and response handling
  • Better Resource Usage: Improved efficiency in API request processing

Critical Bug Fixes ✅ (Issue #190)

  • Blacklist Persistence: Fixed blacklist not saving when deleting videos with ‘Add to blacklist’ option
  • Download Callback: Fixed download completion callback not updating records
  • Download History: Fixed Download History not showing completed downloads

Resolved Issues

  • #190: Blacklist not saving info - Videos added to blacklist now persist correctly
  • #191: Video Filtering - Per-artist video type filters for autodownload

Docker Image

docker pull ghcr.io/prefect421/mvidarr:v0.11.7
docker pull ghcr.io/prefect421/mvidarr:latest
Git Commit: 2f6b43e Build: 2026-02-02

📈 Previous Release: v0.11.6

Released: January 2, 2026 Focus: Blacklist POST Hotfix

  • Fixed non-existent ‘reason’ and ‘id’ fields from blacklist POST endpoint
  • Blacklist API/model mismatch fixes
  • Pagination fixes

📈 Previous 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.