Baz00k@
Aplikace / Marvis QT
Ikona Marvis QT
Audio / MIDI

Marvis QT

0.2.5.1

Marvis_QT je modulární audio vizualizér určený pro přehrávače a multimediální aplikace. Nabízí runtime pluginy (.vismod) pro tvůrčí vizualizační režimy (spektrum, částice, plazma, moiré, osciloskop atd.). Jednotlivé pluginy jsou nyní nezávisle nabíjecí, konfigurovatelné a lokalizované do češtiny (CZ)

Co projekt řeší

Marvis_QT je modulární audio vizualizér určený pro přehrávače a multimediální aplikace. Nabízí runtime pluginy (.vismod) pro tvůrčí vizualizační režimy (spektrum, částice, plazma, moiré, osciloskop atd.). Jednotlivé pluginy jsou nyní nezávisle nabíjecí, konfigurovatelné a lokalizované do češtiny (CZ)

Jak aplikace funguje a k čemu slouží

Přehled produktu

Marvis_QT je vysokovýkonný vizualizační engine navržený pro realtime transformaci zvukových vln do komplexních vizuálních vzorů. Aplikace kombinuje výhody vestavěných nativních módů s flexibilitou runtime .vismod pluginů.

Díky podpoře profilů (Standalone, MaVi, ADB) se Marvis dokáže plynule přizpůsobit roli doplňku pro hudební přehrávač nebo samostatné VJ platformy. Klíčovým prvkem verze 0.2.5.x je Global-First Asset Lookup, který sjednocuje vizuální styl napříč celým ekosystémem MFilmDB.

UI workflow

Marvis používá "Hybridní rozhraní" – renderovací plocha je čistá, zatímco ovládací prvky jsou dostupné přes RMB (Right Mouse Button) nebo klávesové zkratky.

  • Práce s módy: Menu Modes nabízí seznam vestavěných efektů i detekovaných pluginů.
  • Overlay panely: Po vyvolání (např. klávesou F1 pro Help) se zobrazí borderless panel, který lze přesouvat tažením za titulkovou lištu.
  • Konfigurace v reálném čase: Plugin specifikace (např. Sensitivity) lze měnit za běhu bez přerušení renderu.

Klávesové zkratky

Okamžité přepnutí módu na daném indexu.
Toggle Fullscreen.
Zobrazení hlavního menu pod myší.
Zavření vrchního overlay panelu.
Změna globální Opacity (průhlednosti).
Safe Quit (uložení stavu a ukončení).

Scénáře a workflow

Workflow: Profesionální VJ setup

  1. Spustit s profilem na druhém monitoru.
  2. Nastavit .
  3. Pomocí do celoobrazovkového režimu.
  4. V menu zakázat kurzor myši (Settings).

Workflow: Vývoj pluginu

  1. Otevřít .
  2. Upravit kód a uložit pod novým jménem.
  3. V aplikaci vybrat Plugins → Reload Plugins.
  4. Použít Benchmark panel pro kontrolu výkonu nového kódu.

Formáty + backendy

  • Audio: PCM (přes ). Podpora Stereo i Mono (duplikace streamu).
  • Vizuál: RGB/RGBA surfaces (Pygame). HW akcelerace přes SDL2.
  • Ikony: SVG (vektor) s rasterizací, PNG, WebP (pokud backend dovolí).
  • Metadata: JSON pro nastavení, .vismod (Python source) pro pluginy.

Troubleshooting + known limits

  • Chyba: "No audio device found": Ověřte, zda jiná aplikace nedrží exkluzivní zámek na mikrofonu.
  • Chyba: "ModuleNotFoundError: pygame": Spusťte v příslušném .venv.
  • Limit: Maximální FPS je limitováno obnovovací frekvencí monitoru (pokud je zapnut V-Sync).

FAQ

Jak přidat vlastní ikonu k pluginu?
Vložte SVG do s názvem a tento název uveďte v pluginu do .
Podporuje Marvis ASIO?
Ano, přes backend, pokud jsou v systému nainstalovány ASIO ovladače.

GPU runtime · září 2026

Formální release zůstává 0.2.5.1, ale runtime od té doby prošel rozsáhlým GPU laděním. ModernGL cesty používají native_gpu nebo gpu_bridge a tam, kde je to možné, posílají výsledek přes direct_present bez zbytečného čtení obrazu zpět z GPU do CPU. CPU/Pygame větev zůstává kompatibilní fallback, nikoli výchozí architektonický cíl pro GPU režimy.

Benchmarkovací sada pokrývá 52 vizualizačních režimů. V posledním zachyceném měření prošlo 43/52 pipeline kontrolou a 34 režimů drželo alespoň 60 FPS v p90 při 1280×720. Cíl 120+ FPS je nadále předmětem optimalizace; profil proto odděluje dokončenou migraci renderovacích cest od dalšího výkonového ladění.

Součástí práce je také sjednocení pluginů, izolace režimů, odstranění zbytečných GPU→CPU kopírování a zachování plného rozlišení. Automatická redukce rozlišení patří pouze do volitelného low-power fallbacku.