Telepítés
Telepítő és nyilvános csomag még nincs: az alábbi lépések azoknak szólnak, akik hozzáférést kaptak a forráskód tárolójához. Ha még nincs, kérje a Kapcsolat lapon.
Követelmények
Windows
Egy parancs megmondja, hol tart egy gép: a környezetellenőrzés jelenti, mi van meg, mi hiányzik és mi a pótlás parancsa, pótló módban pedig kérdés után tételenként telepít. Csak a virtuális hangkábelnek kell rendszergazdai jog; minden más a saját felhasználójaként települ.
check-environment.cmd
check-environment.cmd -Fix| Mi | Mire | Megjegyzés |
|---|---|---|
| Windows x64 | a feliratablak és a szolgáltatások | Windows 11, vagy Windows 10 2004-es vagy újabb változat, ha a feliratnak ki kell maradnia a képernyőmegosztásból; Windows 10-en és LTSC-kiadásokon a winget csomagkezelőt egyszer kézzel kell telepíteni. |
| .NET 10 SDK, PowerShell 7 | a programok fordítása és futtatása; az indítószkriptek | Mindkettőt a pótló mód telepíti a wingeten át. |
| NVIDIA videokártya friss illesztőprogrammal | a feliratozó szerver, a fordító és a beszédszolgáltatás | Ampere és újabb kártyán a CUDA 13-as futtatókörnyezet kell, régebbin (például Turing) a CUDA 12-es; a feliratozó szerver felajánlja a szükséges futtatókörnyezet letöltését. Kártya nélkül a feliratozó szerver processzoron fut, lassabban, és ezt induláskor ki is írja. A kártya a hálózat egy másik gépében is lehet. |
| Python 3.10–3.12 | a beszédmotor (klónozott és beépített hangok) | A Python 3.13 nem alkalmas, a Microsoft Store-os kiadás sem; a környezet előkészítője felajánlja a 3.12 telepítését. A folyamaton belüli hanghoz nem kell Python. |
| PostgreSQL a Docker Desktopban | a fiókszolgáltatás adatbázisa | A fiókszolgáltatás indítója konténerben futtatja; a Docker Desktop a WSL-re épül, és ha hiányzik, a pótló mód telepíti. Csak azon a gépen kell, ahol a fiókszolgáltatás a saját adatbázisával fut. |
| FFmpeg | a parancssori feliratozó kliens (videó- és hangfájlok olvasása) | Ha hiányzik, a kliens felajánlja a letöltését és a beállítását. |
| Virtuális hangkábel: VB-CABLE, mindkét irányhoz az A+B csomag is | a hívás hangja befelé, a tolmács hangja kifelé | Adományalapú, ezért nem terjesztjük: a csomagokat kézzel kell letölteni és a Resources mappába tenni, onnan a telepítő szkriptek megtalálják. A csak bejövő módot egy kábel kiszolgálja, a két irányhoz kettő kell. |
| Fejhallgató | amikor a tolmács megszólal | Hangszóróból a tolmács saját hangja visszakerülne a feliratozásba. |
| Internet az első letöltésekhez | az eszközök és a modellek | Utána minden offline megy; a modellek az adatgyökér alatt tárolódnak. |
macOS
macOS-en ugyanez a környezetellenőrzés a check-environment.command indítóval fut (a Finderben dupla kattintással is). A hiányzó tételeket a pótló mód nem telepíti magától, mert rendszergazdai jelszót kérhetnek: a pótlás parancsát írja ki – a .NET SDK-hoz a Microsoft telepítőszkriptjét (dotnet-install.sh), a többihez a Homebrew parancsát.
./check-environment.command
./check-environment.command -Fix| Mi | Mire | Megjegyzés |
|---|---|---|
| Apple siliconos Mac | a feliratablak és a szolgáltatások | macOS 14.2 vagy újabb. Intel processzoros Macen a szolgáltatások nem futnak. A feliratablakhoz aktív kijelző kell: kijelző nélküli Macen csak a szolgáltatások futnak. |
| .NET 10 SDK, PowerShell 7 | a programok fordítása és futtatása; az indítószkriptek | A Homebrew-val: brew install --cask powershell és brew install --cask dotnet-sdk. PowerShell 7 nélkül egyetlen indító sem indul el, és ezt meg is mondja; a kész LiveCaption Pro.app futásához a .NET SDK már nem kell. |
| Az Apple silicon GPU-ja (Metal) | a feliratozó szerver, a fordító és a beszédszolgáltatás | A feliratozó szerver és a fordító a Metal-on át gyorsít, a beszédmotor az mps eszközön. Külön videómemória nincs: a modellek az egységes memóriában osztoznak a rendszerrel. Ha a Metal nem indul el, a feliratozó szerver hangosan processzorra vált. |
| Python 3.10–3.12 | a beszédmotor (klónozott és beépített hangok) | macOS-en a 3.12 az alap: a környezet előkészítője előbb az uv saját értelmezőjét, utána a Homebrew python@3.12 csomagját használja (brew install uv vagy brew install python@3.12). |
| PostgreSQL 18 a Homebrew-ból | a fiókszolgáltatás adatbázisa | brew install postgresql@18. A projekt ebből saját adatbázis-fürtöt kap az adatgyökér alatt, saját mappában, csak a loopback címen; Docker nem kell. |
| FFmpeg | a parancssori feliratozó kliens (videó- és hangfájlok olvasása) | brew install ffmpeg – a kliens saját letöltője csak Windowson tölt le. |
| Virtuális hangkábel: BlackHole 2ch (vagy 16ch) | a hívás hangja befelé, a tolmács hangja kifelé | brew install --cask blackhole-2ch. Egy eszköz mindkét irányban: a lejátszó és a rögzítő vége ugyanaz. Ha a telepítés után nem jelenik meg a hangeszközök között, a gépet kell újraindítani – a hangrendszer újraindítása nem elég. A Windows kábeltelepítője macOS-en nem fut. |
| Engedélyek: Mikrofon és rendszerhang-rögzítés | a hang rögzítése | A macOS annak adja, aki az indításért felel: szkriptből indítva a terminálalkalmazás, a Finderből indított LiveCaption Pro.app-nál maga a program. Tanúsítvány nélküli (ad hoc) aláírással minden programfrissítés után újra kérheti. A macOS Élő feliratok forráshoz a Kisegítő lehetőségek engedélye is kell. |
| Fejhallgató | amikor a tolmács megszólal | Hangszóróból a tolmács saját hangja visszakerülne a feliratozásba. |
| Internet az első letöltésekhez | az eszközök és a modellek | Utána minden offline megy; a modellek az adatgyökér alatt tárolódnak. |
Videómemória
A három motor egy kártyán osztozik, és a feliratozó szerver a szabadon maradt memóriához méretezi a modellkészletét – ezért kötött az indítási sorrend. Ezek a mért összeállítások; ha a kártya kisebb, a fordító kisebb modellváltozatot választ, vagy a szolgáltatások arra a gépre költöznek, amelyikben a kártya van.
| Mit mértünk | Eredmény | Milyen feltétellel |
|---|---|---|
| Videómemória a három motornak együtt | 22,3 GB | Egy gépen mérve, a legnagyobb fordítómodellel. 20 GB-os kártyán a fordító 12b Q4_K_M változata fut (mérve 7,5 GB), 32 GB-oson a 12b Q8_0. |
| A fordító videómemóriája a kisebb modellváltozattal | 7,5 GB | TranslateGemma 12b Q4_K_M; a Q8 változatnak 16,7 GB kell. |
| A beszédszolgáltatás videómemóriája | 2,3 GB | XTTS-v2; a folyamaton belüli hangnak nem kell. |
Mérőgép: NVIDIA GeForce RTX 5090, Intel Core i9-13900K, 128 GB RAM; 2026. szeptember. Más gépen más szám jön ki; Macen mért számokat ezen a lapon nem közlünk. A tolmács idői mediánok (p50): a mondatok felénél rövidebb volt; a 95. percentilis és a torlódás miatt kihagyott mondatok aránya a Hogyan működik lapon áll.
macOSApple siliconon nincs külön videómemória: a feliratozó szerver a Metal ajánlott munkakészletéből és a rendszer szabad memóriájából számol, így a mellette futó fordító foglalását is látja. Macen mért összeállítást ezen a lapon nem közlünk.
Az első indítás, sorrendben
A sorrend számít: minden szolgáltatás a fiókszolgáltatáson át hitelesít, tehát annak léteznie kell, mielőtt a többi elindul.
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 gyökérmappájából fut.
A környezet ellenőrzése, majd pótlása
A jelentés mód semmit nem módosít. A pótló mód tételenként kérdez, előre megmondja, mekkora a letöltés és kér-e rendszergazdai jogot, és pótolja, ami hiányzik.
check-environment.cmd check-environment.cmd -FixmacOSmacOS-en előbb a PowerShell 7 kell; utána a check-environment.command ugyanígy jelent és pótol, a Homebrew-tételeknek csak a parancsát írja ki.
brew install --cask powershell ./check-environment.command ./check-environment.command -FixA fiókszolgáltatás indítása
Indítsa a saját, látható ablakában: az első indulás létrehoz egy rendszergazdát, és a véletlen jelszavát egyszer kiírja – naplóba sosem. Ezután lépjen be az admin lapján, ahol a felület rögtön új jelszót kér, és a Kulcsok lapon adjon kulcsot a klienseknek.
AccountServer\start-accountserver.cmd http://127.0.0.1:8101/adminmacOSmacOS-en az indító .command párja fut, és az adatbázishoz nem kell Docker: a Homebrew postgresql@18 programjaival saját, natív fürt készül.
brew install postgresql@18 AccountServer/managed-postgres.command AccountServer/start-accountserver.commandA szolgáltatások bekötése a fiókszolgáltatásba
A peer token-beállító szkript kiadja a három szolgáltatás kulcsát, hitelesített teszttel ellenőrzi őket, majd aktiválja a fiókszolgáltatás címét. A cím környezeti változó, amit a futó ablakok nem látnak: utána minden nyitott ablakot zárjon be.
AccountServer\setup-account-peers.ps1 -Tokens AccountServer\setup-account-peers.ps1 -Check AccountServer\setup-account-peers.ps1 -ActivatemacOSmacOS-en a setup-account-peers.command ugyanezekkel a kapcsolókkal; a tartós változók ott a felhasználó környezeti fájljába kerülnek (~/.config/live-caption-pro/environment), és az indítók onnan olvassák be őket.
AccountServer/setup-account-peers.command -Tokens AccountServer/setup-account-peers.command -Check AccountServer/setup-account-peers.command -ActivateKulcs a parancssori szkripteknek
A kötegelt feliratozás és a fájlfordítók saját kulcsot használnak, ami szolgáltatásonként egy tartós környezeti változóban áll. A kulcsgeneráló úgy adja ki, hogy sehol nem mutatja meg, és a meglévő kulcsot sosem írja felül. A szkriptek maguk is kérik, ha először futnak kulcs nélkül.
generate-api-key.cmdmacOSmacOS-en a generate-api-key.command adja ki, ugyanezekkel a kapcsolókkal; a kulcs a tartós környezeti fájlba kerül.
./generate-api-key.commandA napi indító
Egy indító hozza fel a négy háttérszolgáltatást a kötött sorrendben – fiókszolgáltatás, majd a fordító és a beszédszolgáltatás, végül a feliratozó szerver –, mindegyiket a saját ablakában. A feliratablakot külön indító indítja; kiszolgáló gépen erre nincs szükség. Ami másik gépen fut, az egy kapcsolóval marad ki.
launch-system.cmd LiveCaption\start-livecaptionpro.cmdmacOSmacOS-en a launch-system.command hozza fel a szolgáltatásokat, a feliratablakot a LiveCaption/start-livecaptionpro-avalonia.command indítja. A szolgáltatások Terminal-ablakban indulnak, ezért grafikus munkamenet kell – SSH-ról ez nem megy. A publikálás önálló LiveCaption Pro.app csomagot készít, ami a Finderből vagy a Dockból is indítható; futás közben a program a menüsorban él.
./launch-system.command LiveCaption/start-livecaptionpro-avalonia.commandKulcsok és mód a feliratablakban
A beállítóablak Szerverek lapján adja meg a három szolgáltatás címét és kulcsát; a Használat lapon válassza ki, mire használja a programot, és a lap kiírja, mit hova kell beállítani.
macOSmacOS-en a mikrofon és a rendszerhang rögzítése engedélyhez kötött, és a kulcsokat a program a macOS-kulcstárban (Keychain) tartott kulccsal titkosítja: a Windowsról átmásolt kulcsokat újra be kell írni.
Ugyanezek a lépések minden paranccsal és a várt kimenettel az útmutatókban vannak:
Környezeti változók
Ezek a változók döntik el, hol tartja a termék az adatait, és hogyan találják meg egymást a részek. A változás csak az utána megnyitott ablakokhoz jut el.
| Változó | Mit csinál |
|---|---|
| LCP_HOME | Az adatgyökér: a modellek, a kalibráció, a naplók és a felvételek ez alatt élnek. Nélküle minden a felhasználói profil helyi alkalmazásadatai alatt marad. |
| LCP_LANGUAGE | Az a nyelv, amit egyébként a gép döntene el: a naplónyelv és a felület nyelve automatikus módban. Értékei: auto, hu, en. |
| LCP_ACCOUNT_URL | A fiókszolgáltatás címe. Kötelező: nélküle a három szolgáltatás el sem indul. A peer token-beállító szkript állítja be. |
| LCP_ACCOUNT_TOKEN_<SERVICE> | Egy szolgáltatás peer tokenje (a név a szolgáltatás nevére végződik). Maga a szolgáltatás olvassa; parancssorba sosem kerül. |
| LCP_SCRIPT_KEY_<SERVICE> | A parancssori szkriptek saját kulcsa egy szolgáltatáshoz. A kulcsgeneráló írja, a szkriptek olvassák. |
| LCP_INSTANCE | Egy szolgáltatáspéldány neve, ha egy gépen több példány fut. |
Eltávolítás
Egy parancs leszedi, amit a termék telepített vagy letöltött, és tisztán hagyja a munkaállomást. 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 – pedig külön kell kérni, mert a gépen más is használhatja őket. A repóhoz, a történetéhez és a tesztanyaghoz sosem nyúl.
uninstall-environment.cmd
uninstall-environment.cmd -RemovemacOSmacOS-en az eltávolítónak nincs indítója, és ott nem is mértük: a Homebrew-val telepített tételeket a brew uninstall szedi le.
Hozzáférést kér? Írjon nekünk.
Írja meg, mire és milyen környezetben használná; a hozzáféréssel és ajánlattal válaszolunk.