MaVi Player
Video přehrávač specializovaný pro MfilmDB. FFmpeg screenshoty, GIF export, DB vyhledávání, WinAmp skiny, visualizer.
Co projekt řeší
Video přehrávač specializovaný pro MfilmDB. FFmpeg screenshoty, GIF export, DB vyhledávání, WinAmp skiny, visualizer.
Typické použití
- Přehrávání videa a audio v nejčastějších formátech
- FFmpeg-powered screenshot capturing (single + burst series)
- GIF animace z videa (s optimalizací, fps control)
- Playlist management (drag-drop, shuffle, repeat, history)
- Integrace s MfilmDB DB (metadata, covers, ratings, film details)
- Pokročilé titulky (embedded + external, multi-track, custom styling)
Jak aplikace funguje a k čemu slouží
Přehled
MaVi Player (MaruškaVideoPlayer) představuje stabilní multimediální jádro projektu MFilmDB. Verze 0.2.1.35 ("WinAmp Skin DnD Parity Edition") uzavírá drag&drop pipeline pro WinAmp skin balíčky i media/subtitles napříč všemi hlavními drop vstupy (main, eventFilter, winamp controller, detached video).
- Primární engine: QtMultimedia (Backend: FFmpeg/GStreamer dle OS).
- Specializace: Bezztrátový capture (screenshoty), správa playlistů a automatická synchronizace metadat z MFilmDB.
- Filosofie: "Single-source rule" — eliminace překrytí více zdrojů titulků současně.
Klíčové vlastnosti
Subtitle Parity Edition
Plná podpora pro API. Přepínání mezi embedded MKV stopami a externími SRT/VTT bez nutnosti restartu.
FFmpeg Capture Engine
Integrace FFmpeg pro "Hold-to-capture" sérii (P / Shift+P). Podpora AnimGIF a Timelapse s vlastní optimalizací FPS.
Hybrid UI (Skins)
Přepínatelný vzhled mezi moderním Qt oknem a "Legacy WinAmp" režimem využívajícím SVG assety a BMP backgroundy.
Persistence & History
Ukládání pozice v playlistu, hlasitosti a naposledy vybrané titulkové stopy do JSON/SQLite databáze.
Podporované formáty
MaVi Player využívá kodeky nainstalované v systému prostřednictvím QtMultimedia backendu.
- Video: MKV (matroska), MP4, AVI, WMV, MOV, FLV.
- Audio: MP3, FLAC, WAV, AAC, OGG.
- Titulky: SRT (SubRip), VTT (WebVTT), ASS/SSA (Advanced Substation Alpha).
Použití
MaVi player je navržen jako přenosný přehrávač spouštěný přímo ze složky nebo pomocí launcherů.
- Z příkazové řádky:
- Drag & Drop: Přetáhněte video soubor přímo na okno aplikace nebo na ikonu launcheru.
- Playlist: Podpora pro a interní formáty playlistů.
Funkce a UI
- WinAmp Skin: Režim emulující klasický WinAmp (main.bmp background, z-order button handling).
- Capture: Screenshoty, hold-to-capture série, AnimGIF (FPS/optimalizace), Timelapse (intervaly).
- Marquee: Název souboru v záhlaví automaticky scroluje, pokud přesahuje šířku okna.
- Recovery: Best‑effort FFmpeg repair při chybách dekodéru (např. AAC invalid bands).
Troubleshooting
| Problém | Řešení |
|---|---|
| Video se přehrává jen trhaně | Ujistěte se, že máte nainstalované vhodné kodeky pro systémový backend (např. K-Lite Codec Pack pro Windows). |
| FFmpeg screenshot nefunguje | Cesta k musí být v systémové PATH nebo ve složce . |
| Titulky se překrývají | MaVi player dodržuje pravidlo single-source. Pokud potíže přetrvávají, smažte konfigurační JSON a restartujte aplikaci. |
FAQ
- Lze změnit klávesové zkratky?
- Ano, většina běžných zkratek je konfigurovatelná přímo v menu Settings.
- Jak funguje WinAmp skin?
- Aplikace podporuje přepnutí do kompaktního režimu, který emuluje vzhled klasických přehrávačů z 90. let (tzv. WinAmp/Skins mód).
Publikace a návody ve Čtení
Srovnávací publikace popisuje MaVi Player v kontextu běžných PC přehrávačů.