Często zadawane pytania

Pipeline działa lokalnie, a identyfikacja gry i opisy scen korzystają z AI Relay po stronie backendu. Piper TTS może działać lokalnie. Zakres wysyłanych danych zależy od konfiguracji Relay.

MP4, MKV, MOV, AVI, WebM — wszystkie popularne formaty obsługiwane przez FFmpeg. Jeśli FFmpeg obsługuje dany format, GameCommentator też go obsłuży. Plik wyjściowy jest zawsze w formacie MP4 (H.264 + AAC).

Tak, FFmpeg jest wymagany do przetwarzania wideo. Instalacja jest prosta:

Windows: winget install ffmpeg
Ubuntu/Debian: sudo apt install ffmpeg
macOS: brew install ffmpeg

Po zainstalowaniu FFmpeg powinien być dostępny w PATH — możesz to sprawdzić komendą ffmpeg -version.

Narzędzie analizuje klatki kluczowe wideo i używa profilu AI Relay do identyfikacji gry. AI Relay analizuje elementy UI, HUD, grafikę i kontekst wizualny, a następnie dopasowuje wynik do dostępnych facts packów. Jeśli gra nie zostanie rozpoznana, używany jest fallback pack _unknown.

Nie. Workflow korzysta z AI Relay po skonfigurowaniu klucza API. Bez klucza nadal działa fallback oparty o facts pack, ale bez analizy obrazu i przepisywania komentarza przez AI Relay.

Użyj Piper TTS z głosem pl_PL-darkman-medium dla polskiego lub en_US-ryan-high dla angielskiego. Edytuj plik config.yml lub użyj flag CLI:

game-commentator run --tts-voice pl_PL-darkman-medium --tts-engine piper

Głosy Piper są bezpłatne i można je pobrać z oficjalnego repozytorium Piper TTS.

Facts pack to plik JSON z faktami o konkretnej grze — mechaniki rozgrywki, postacie, charakterystyczne momenty, żarty, kontekst fabularny, ciekawostki. Komentator używa tych faktów do generowania trafnych, kontekstowych komentarzy.

Plan Free zawiera pack _unknown (generyczny). Plany premium zawierają dedykowane packi dla CS2, Valorant, LoL, Minecraft, GTA V, Cyberpunk 2077, Elden Ring i innych.

Narzędzie automatycznie renderuje output.mp4 z duckowaniem audio i zsynchronizowanym komentarzem głosowym. Plik trafia do katalogu outputs/ w bieżącym folderze. Możesz podać własną ścieżkę wyjściową:

game-commentator run --input gameplay.mp4 --output moj_komentarz.mp4

Tak! Użyj flagi --preview aby zobaczyć wygenerowany skrypt w pliku commentary_script.md bez renderowania wideo. Edytuj go dowolnie, a następnie uruchom render osobno:

game-commentator run --input gameplay.mp4 --preview
# edytuj commentary_script.md
game-commentator render --script commentary_script.md --input gameplay.mp4

Każdą grę poprzez fallback facts pack _unknown — komentarz będzie generyczny, ale działający. Znacznie lepsza jakość dla gier z dedykowanym facts pack:

Free: _unknown (generyczny)
Starter ($9): CS2, Valorant, Minecraft, GTA V, Fortnite, Apex Legends, LoL, DOTA 2, Among Us, Terraria
Pro ($29): 50+ gier w tym Cyberpunk 2077, Elden Ring, RDR2, The Witcher 3, Battlefield i więcej
Studio ($79): Wszystko z Pro + generator własnych facts packów