mkv2cast Documentation
mkv2cast is a smart MKV to Chromecast-compatible converter with hardware acceleration support.
Features
Intelligent codec detection - Automatically detects H.264, H.265/HEVC, and AV1
Hardware acceleration - Supports NVIDIA NVENC, AMD AMF, Intel QSV, and VAAPI (auto-pick)
Parallel processing - Multi-threaded encoding with pipeline mode
Rich progress UI - Beautiful progress display with multiple workers
Automatic audio selection - Prefers French audio tracks (configurable)
Audio & subtitle selection - Choose by language or explicit track index
Integrity checking - Verifies files before processing
Watch mode - Watchdog/inotify monitoring with optional systemd service
JSON progress - Stream structured events for dashboards or integrations
XDG compliant - Follows XDG Base Directory specification
Multi-language - Supports EN, FR, ES, IT, DE
Desktop notifications - Get notified when conversions complete
Quick Start
Installation:
pip install mkv2cast
Usage:
# Convert all MKV files in current directory
mkv2cast
# Convert a single file
mkv2cast movie.mkv
# Use CPU encoding with fast preset
mkv2cast --hw cpu --preset fast
Contents
Getting Started
Usage Guide
- Basic Usage
- Advanced Usage
- Hardware Acceleration
- File Filtering
- Library Usage Guide
- Using mkv2cast as a Python Package
- Installation
- Basic Usage
- Script Mode and Library Usage
- Configuration
- Analyzing Files
- Progress Callbacks
- Batch Processing (Sequential)
- Batch Processing with Multi-threading
- Advanced: Building Custom Commands
- Working with History
- Loading Configuration Files
- Getting Application Directories
- Sending Notifications
- Internationalization
- Complete Example Script
- Advanced: Async Integration
- Advanced: Webhook Integration
- JSON Progress Output
- API Reference
API Reference
Development