Rendszerkövetelmények és telepítés

A LiveCaption ma nem telepítőből, hanem a forráskód tárolójából (a repóból) kerül a gépre: aki hozzáférést kapott, klónozza, és az indítószkript az első indításkor maga készíti el a futtatható programot. Ha még nincs hozzáférése, a Kapcsolat lapon kérheti. Ez a fejezet azt mondja el, mi kell a géphez, és hogyan jut el az első elindított feliratablakig.

Mi kell a géphez

A LiveCaption maga – a feliratablak és a beállítóablak – kis erőforrásigényű program. A nehéz munkát (a beszéd átírását, a fordítást, a tolmács hangját) a szerverek végzik; ezekről a következő szakasz szól.

Mi	Windows	macOS
Rendszer	Windows x64: Windows 11, vagy Windows 10 2004-es vagy újabb változat	Apple Silicon (M-sorozatú) Mac, macOS 14.2 vagy újabb
.NET 10 SDK és PowerShell 7	a program elkészítéséhez és az indítószkriptekhez; a környezetellenőrzés pótló módja telepíti	ugyanez; a kész programcsomag futásához már nem kell
Virtuális hangkábel	VB-CABLE – hívásban kell; a két irányhoz az A+B csomag is	BlackHole 2ch (vagy 16ch)
Fejhallgató	amikor a tolmács megszólal	ugyanez
Internet	csak az első letöltésekhez (eszközök, modellek)	ugyanez

• A képernyőmegosztásból való kizárás – hogy a hívás többi résztvevője ne lássa a feliratot – Windowson a 2004-es változattól működik. Régebbi Windowson a program elindul, de figyelmeztet, hogy a felirat megjelenhet a megosztott képen.
• A fejhallgató nem kényelmi kérdés: hangszóróból a tolmács hangja visszakerülne a mikrofonba, és a program a saját fordítását feliratozná újra.
• A virtuális hangkábel csak hívásban kell (amikor a program a hívás hangját hallgatja, vagy a tolmács hangját viszi a hívásba). Előadás vagy videó feliratozásához nem kell. A beállítása a Hívásban: virtuális kábel, kimenő irány fejezetben áll.
• A VB-CABLE adományalapú, ezért nem terjesztjük: a csomagokat kézzel kell letölteni, és a repó Resources mappájába tenni, onnan a telepítő szkriptek megtalálják. A telepítése az egyetlen lépés, amely rendszergazdai jogot kér.

Mi kell a szerverekhez

A feliratot, a fordítást és a tolmács hangját három szerver adja (feliratozó, fordító, beszédszolgáltatás), és mindegyik mögött áll a fiókszolgáltatás, amely a kulcsokat és a jogosultságokat kezeli. A szerverek futhatnak ugyanazon a gépen, ahol a LiveCaption, vagy egy erősebb, videokártyás gépen a hálózatban.

• Ha a szerverek ezen a gépen futnak, a gépnek a szerverek követelményeit is teljesítenie kell (Windowson NVIDIA videokártya friss illesztőprogrammal, Python a beszédmotorhoz). Ezeket az Előfeltételek és környezetellenőrzés fejezet sorolja fel.
• Ha a szerverek másik gépen futnak, ezen a gépen elég a fenti táblázat; a LiveCaption csak a szerverek címét és egy kulcsot kér.
• Videokártya és szerver nélkül Windowson a rendszer saját felismerője, a Windows Élő feliratok is lehet a felirat forrása – fordításhoz ilyenkor is kell egy elérhető fordító.

A videómemória mért összeállításait a weboldal Telepítés lapja mutatja.

Hogyan kerül fel a gépre

1. A repó klónozása

Klónozza a forráskód tárolóját a teljes történetével a gépre. Minden további lépés a repó gyökérmappájából fut.

2. A környezet felmérése

Egy parancs megmondja, hol tart a gép: jelenti, mi van meg, mi hiányzik, és mi a pótlás parancsa. A jelentés semmit nem módosít; a pótló mód tételenként kérdez, és előre megmondja, mekkora a letöltés, és kér-e rendszergazdai jogot.

check-environment.cmd
check-environment.cmd -Fix

Windowson a winget csomagkezelő maga is előfeltétel: Windows 10-en és LTSC-kiadásokon egyszer kézzel kell telepíteni. macOS-en a jelentést a check-environment.command adja (a Finderben dupla kattintással); az alkalmazás eszközei a Homebrew-val is felkerülnek:

brew install --cask powershell
brew install --cask dotnet-sdk
brew install --cask blackhole-2ch

A jelentés jelölései: + megvan, ! hiányzik és kötelező, - hiányzik, de nem kötelező, ? nem eldönthető.

3. Az egész rendszer egy lépésben (ha a szerverek is ezen a gépen futnak)

A setup-system.cmd (macOS-en setup-system.command) végigmegy a teljes helyi rendszer felállításán – az előfeltételek pótlása, a fordítómodellek letöltése, a fiókszolgáltatás és a kulcsok –, és ahol kell, kérdez. Utolsó lépésként a LiveCaption kulcsait is beírja a beállításaiba, így az első indításkor a Szerverek lapon már ki van töltve minden. Minden lépése megismételhető: egy félbeszakadt futás újraindítva ott folytatódik, ahol abbamaradt. A szerveroldal részletei a Telepítés és eltávolítás fejezetben állnak.

Ha a szerverek másik gépen futnak, ez a lépés elmarad: a kulcsot a szerverek gazdája adja, és a beállítóablakban kell beírni.

4. A LiveCaption indítása

Rendszer	Indító	Megjegyzés
Windows	LiveCaption\start-livecaptionpro.cmd	magyar kiírásokkal: start-livecaptionpro-langhu.cmd
macOS	LiveCaption/start-livecaptionpro-avalonia.command	magyar kiírásokkal: start-livecaptionpro-avalonia-langhu.command; a Finderben dupla kattintással

Az indító elkészíti (publikálja) a programot, ha még nincs kész, vagy ha a forrás azóta változott – erre nem kérdez rá, csak megmondja, miért kezd bele –, majd elindítja. Az első alkalom néhány percig tarthat. Szervert nem indít és nem is vizsgál: a háttérszolgáltatásokat a napi indító (launch-system.cmd, macOS-en launch-system.command) hozza fel, a LiveCaption előtt.

Windowson van egy második felület is (start-livecaptionpro-avalonia.cmd): ugyanazt tudja, ugyanazt a beállításfájlt használja, és egyszerre csak az egyik futhat.

macOS-en: a programcsomag és az engedélyek

A publikálás macOS-en önálló LiveCaption Pro.app csomagot készít a LiveCaption/LiveCaption.Avalonia/bin/publish-osx-arm64/ mappába. Ez a Finderből közvetlenül is indítható, és a Dockra húzva onnan egy kattintással. Futás közben a program a menüsorban él: a Dockban nincs „fut” pötty, és a Cmd+Tab sem mutatja.

A macOS a mikrofont és a rendszerhang rögzítését engedélyhez köti, és az engedélyt annak a programnak adja, amelyik az indításért felel:

• szkriptből indítva (.command) a terminálalkalmazás (Terminal, iTerm) kapja a Mikrofon és a rendszerhang-rögzítés engedélyét, és a LiveCaption tőle örökli;
• a Finderből vagy a Dockból indítva maga a Live Caption Pro kéri, a saját nyelvén.

Az engedélyek a Rendszerbeállítások → Adatvédelem és biztonság alatt láthatók. Ha a program a gép hangját hallgatja, de csak csend jön, miközben más program szól, valószínűleg a rendszerhang engedélye hiányzik – a program naplója ilyenkor figyelmeztet.

A csomag alapból tanúsítvány nélkül van aláírva, ezért a macOS minden programfrissítés után újra kérheti a mikrofon- és a rendszerhang-engedélyt. Ez nem hiba; az engedély megadása után a felirat ugyanúgy működik.

A kulcsokat a program macOS-en a macOS-kulcstárban (Keychain) tartott kulccsal titkosítja. Ha a kulcstár hozzáférést kér a Live Caption Pro számára, engedélyezze. A Windowsról átmásolt beállításfájl kulcsai macOS-en nem olvashatók: azokat újra be kell írni.

Kijelző nélkül a program nem indul: alvó kijelzőnél az indító előbb felébreszti, és rövid ideig vár rá. Kijelző nélküli Macen a szerverek futhatnak, a feliratablak nem.

Egyszerre egy példány

A gépen egyszerre egy LiveCaption fut. Ha már fut egy – bármelyik bejelentkezett felhasználónál –, az indító nem indít másikat, hanem figyelmeztet és kilép (7-es kóddal); a program közvetlenül indítva is üzenettel lép ki, és az első marad. Két példány ugyanazokat a hangeszközöket nyitná és ugyanazt a beállításfájlt írná. Futó program mellett frissíteni sem lehet: előbb lépjen ki belőle (a menüből vagy a feliratablak × gombjával).

Eltávolítás

Windowson az uninstall-environment.cmd leszedi, amit a termék telepített vagy letöltött. Alapból csak jelenti, mi menne el, és mekkora helyet szabadítana fel; a törlés tételenként kérdez. A gépszintű eszközöket – Python, .NET SDK, PowerShell 7, hangkábel – külön kell kérni, mert a gépen más is használhatja őket. A repóhoz és a történetéhez sosem nyúl.

Hova tovább

• Első indítás, kapcsolódás a szerverekhez
• A teljes sorrend egy szűz gépen, minden paranccsal: az Első indítás útmutató.