Download
Lightweight cross-platform video player (Ada + SDL2 + FFmpeg). Support player for the BlackVideo. Works standalone via CLI or right-click on any video file.
Usage
Method 1 — Command Line
Step 1. Unzip blackvideo-mini-player-v2.3.0.win.zip
Step 2. Open the build\ folder, then type cmd directly in the address bar and press Enter — this opens a terminal already in that folder.
Alternatively: open Command Prompt anywhere and use cd with the copied path:
cd "C:\path\to\blackvideo-mini-player\build"
Step 3. Run the player:
blackvideo-player.exe "C:\Users\You\Videos\movie.mp4"
Method 2 — Right-Click (Recommended)
Step 1. Unzip blackvideo-mini-player-v2.3.0.win.zip
Step 2. Right-click tools\context_menu\install_context_menu.bat → Run as administrator
That's it. Now:
Right-click any video file in Explorer
Click Open with BlackVideo Player
The video plays immediately
To remove the right-click entry:
tools\context_menu\uninstall_context_menu.bat
Features
- Video Playback Plays MP4, MKV, AVI, MOV, WMV, WebM, FLV, M4V, MPEG, TS and more Hardware-accelerated SDL2 rendering with letterbox scaling — preserves aspect ratio at any window size or fullscreen Correct frame pacing at any FPS (24, 30, 60 fps) using real elapsed-time budgeting
- Audio Full audio playback with volume control, mute, and seek flush Supports AAC, MP3, AC3, and other common codecs via FFmpeg 2 MB ring buffer with SDL audio lock — stable for multi-hour playback without corruption or drift
- On-Screen Controls (UI Bar) Seek bar with scrubber — click or drag to jump anywhere Play / Pause, Previous (seek to start), Next (jump to end) Loop toggle, Mute / Unmute, Speed selector (0.5× / 1.0× / 1.5× / 2.0×) Fullscreen toggle, context menu button Auto-hides after 3 seconds of mouse inactivity; reappears on any mouse movement
- Context Menu (Right-click) Open Video File Subtitle track selector (3 slots — load any .srt, .ass, .ssa, or .vtt file per slot) Generate Captions (Whisper) — offline AI transcription Translate to English (Whisper) — offline AI translation
- Subtitles Load up to 3 subtitle tracks from external files Active track renders on-screen above the control bar with a shadow box for readability Context menu always shows the active track name — no guessing whether subtitles are on or off
- Offline Caption Generation — Whisper.cpp Generate subtitles for any video without internet or API keys using whisper.cpp Transcribes in the video's original language, or translates to English Runs in the background — player stays responsive while Whisper works Progress banner shown in the control bar; result auto-loads into Track 1 when done Hot-swappable models: drop in ggml-base.bin, ggml-small.bin, ggml-medium.bin, or ggml-large.bin — no rebuild needed Translation currently outputs English only. Multi-language translation target support is planned for a future version.
- Keyboard Shortcuts
- Windows Shell Integration Right-click installer registers "Open with BlackVideo Player" for all common video extensions Supports: .mp4 .mkv .avi .mov .wmv .webm .flv .m4v .mpg .mpeg .ts
Project Samples
