A böngésző önmagában nem futtathat programot a gépeden (sandbox). De az operációs rendszer tud regisztrálni egy úgynevezett protocol handlert: ha rákattintasz egy cinege://record linkre, az OS elindítja a hozzá rendelt helyi alkalmazást (a Sidecart) és átadja neki a paramétert. Ezt a Felvétel gomb is használja.

Egyszer kell beállítani gépenként — utána a Felvétel gomb minden böngészőből (Chrome, Edge, Firefox) működik.

1. Sidecar telepítés (egységes mappa)

Másold a Sidecar csomagot (a teljes cinege-sidecar-win32-x64 mappa tartalma — cinege-sidecar.exe + locales/ + resources/ + dll-ek) minden gépen ide:

A csomag a Cinege repóban a csp-cinege/sidecar mappában készül (npm run build után npx @electron/packager . cinege-sidecar --platform=win32 --arch=x64 --out=release --overwrite).

2. Windows — protocol handler regisztráció

Mentsd el az alábbit cinege-protocol.reg néven, majd dupla kattintással futtasd (admin nem kell):

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Classes\cinege]
@="URL:cINege Sidecar Protocol"
"URL Protocol"=""

[HKEY_CURRENT_USER\Software\Classes\cinege\DefaultIcon]
@="C:\\cINege\\sidecar\\cinege-sidecar.exe,0"

[HKEY_CURRENT_USER\Software\Classes\cinege\shell]

[HKEY_CURRENT_USER\Software\Classes\cinege\shell\open]

[HKEY_CURRENT_USER\Software\Classes\cinege\shell\open\command]
@="\"C:\\cINege\\sidecar\\cinege-sidecar.exe\" \"%1\""

Központi kihelyezéshez (GPO / Intune) ugyanezt HKEY_LOCAL_MACHINE\Software\Classes\cinege ágba is teheted — akkor minden user kapja, telepítéskor egyszer.

3. macOS / Linux — röviden

• macOS: az Electron Sidecar Info.plist-jébe CFBundleURLTypes + CFBundleURLSchemes = ["cinege"]; első indításkor app.setAsDefaultProtocolClient('cinege') regisztrál.
• Linux: ~/.local/share/applications/cinege-sidecar.desktop fájlba MimeType=x-scheme-handler/cinege; sor, majd update-desktop-database ~/.local/share/applications.

4. Mit tud a Felvétel gomb (most)

• cinege://record — Sidecar elindul codegen módban, az UI-ban beállított alapértelmezett URL-lel. Auto-start: be (ha be vagy lépve a Sidecarba).
• cinege://record?url=https://kesmarki.dev.solyom.ai/dashboard — a Playwright codegen ezzel a cél URL-lel indul.
• cinege://record?url=...&autostart=0 — a Sidecar csak előtérbe jön és beállítja a célt; az indítást neked kell megnyomni a Felvétel gombbal.
• Ha még nem vagy bejelentkezve a Sidecarba, a deep link paraméterek megőrződnek és a sikeres login után automatikusan elindul a felvétel.
• Ha még nincs telepítve a handler vagy a Sidecar, a böngésző „nem talált alkalmazást” üzenetet ad — ekkor a fenti 1–2. lépést kell elvégezni.

5. Tesztelés

Kattints rá és nézd meg, elindul-e:

▶ Próba: cinege://record indítása   ▶ Próba: dev dashboard megnyitása

A Sidecar oldali fogadás (app.setAsDefaultProtocolClient('cinege') + second-instance argv parser + auto-start a renderer-ben) élesben fut. Ha a Sidecar már nyitva van, ugyanaz az ablak veszi át a deep linket (single-instance lock).