Bitfrost FX — användarmanual

1. Logga in via /auth (Google eller e-post).
2. Välj eller skapa en workspace via Workspace-väljaren uppe till vänster.
3. Bjud in kollegor via Workspace-inställningar om ni är ett team.
4. Skapa scener i studion (huvudvyn) — scoreboard, lower-third, ticker, lineup, eller en custom-scen.
5. Öppna kontrollpanelen via knappen 'Kontrollpanel' för att styra sändningen live.
6. Lägg in EN URL i OBS: /overlay/program?workspace=DIN_WORKSPACE_ID som Browser Source. Allt du sätter live i Program-panelen syns där automatiskt.

• Admin: full kontroll, kan radera workspace och bjuda in/ta bort medlemmar.
• Editor: kan skapa, redigera och styra scener och innehåll.
• Viewer: kan se scener och kontrollpanelen, men inte ändra något.

Bjud in via Workspace-inställningar → Generera inbjudningslänk. Länken är giltig i 7 dagar.

• Scenlistan till vänster: skapa, byt namn, duplicera, radera scener.
• Canvas i mitten: live-förhandsgranskning. Klicka på lager för att markera, dra för att flytta.
• Lager-panelen till höger: ordning, synlighet, lås, stilar och animationer per lager.
• Bottenpanelen: media-bibliotek, presets, scen-inställningar.

Öppna scoreboard-blocket i kontrollpanelen för att styra matchen.

• Poäng: +/− knappar för hemma och borta. Klicka på siffran för att skriva exakt värde.
• Klocka: Start/Pause/Reset. Snabbjustering −10s, −1s, +1s, +10s. Snabb-presets 45:00 och 90:00.
• Period: skriv fritt (1ST, 2ND, HT, FT) eller använd snabbknappar.
• Lag: redigera namn och kortnamn direkt i scoreboard-blocket.

• Rubrik (t.ex. namn) + subtitel (t.ex. roll).
• Visa/dölj med ett klick — animationen sköts automatiskt.
• Stilen styrs i lager-panelen i studion (typsnitt, färg, animation).

• Lägg till/ta bort items i listan.
• Hastighet justeras med slider (eller via Stream Deck).
• Töm hela tickern med ett klick.

1. Lägg till lag och spelare under Workspace → Lag.
2. Skapa en lineup-scen och välj vilket lag som ska visas.
3. Spelare hämtas automatiskt utifrån sortering och tröjnummer.

• Ladda upp via media-knappen i bottenpanelen eller direkt när du lägger in en bild.
• Markera 'I bibliotek' för att återanvända i flera scener.
• Filer lagras per workspace.

Knapparna är privata per användare och sparas per workspace. Andra operatörer ser sina egna knappar.

1. Gå till /program. Scrolla under scenlistan tills du ser 'Kontrollpanel'.
2. Klicka 'Lägg till knapp' — redigeringsdialogen öppnas direkt.
3. Sätt etikett, färg, vilken scen knappen ska påverka och vilken åtgärd som ska köras.
4. Spara. Knappen dyker upp i rutnätet.
5. Dra knappen för att flytta. Dra det lilla hörnet längst ner till höger för att ändra storlek.
6. Högerklicka (eller dubbelklicka) på en knapp för att redigera eller ta bort den.
7. Vänsterklicka för att köra knappens åtgärd.

• Visa / dölj scen — togglar synligheten precis som ögat i kontrollpanelen.
• Solo — visar bara den valda scenen och döljer alla andra i ett klick.
• Sätt värde i scen-data — skriv in ett fält (t.ex. homeScore) och ett värde. Bra för att nollställa eller hoppa till en känd ställning.
• Öka räknare — skriv ett fält och ett steg (t.ex. +1 eller -1). Perfekt för poäng-knappar.

Skriv fältet med punktnotation. För scoreboard-scener ligger fälten i roten (t.ex. homeScore). För Custom-scener med inbäddat scoreboard ligger de under scoreboard.* (t.ex. scoreboard.homeScore).

Scoreboard-fält:

• homeScore / awayScore — heltal, hemma- och bortapoäng.
• homeName / awayName — fullständigt lagnamn (text).
• homeShort / awayShort — kortnamn (3 bokstäver, text).
• homeColor / awayColor — primärfärg som hex (#RRGGBB).
• homeLogo / awayLogo — URL till loggan (text).
• period — fritext (1ST, 2ND, HT, FT, P1, P2…).
• clock — klocksträng (t.ex. '12:34'). Servern tickar normalt själv.
• status — valfri statusrad (t.ex. 'PAUS', 'STRAFF').

Lower-third-fält:

• title — rubrik (t.ex. namn).
• subtitle — underrubrik (t.ex. roll).

Bug (kanal-logga / liten skylt):

• text — texten som visas.
• position — hörn: tl, tr, bl, br (top-left, top-right, bottom-left, bottom-right).

Ticker (rullande nyhetsband):

• items — array med strängar (svårt att sätta från en knapp; använd hellre kontrollpanelen direkt).
• speed — heltal, hastighet i px/s.

Lineup:

• teamName — lagets namn.
• formation — formationssträng (t.ex. '4-3-3').

Det här är två olika saker som det är lätt att blanda ihop:

I en SCOREBOARD-scen är det enkelt — alla fält ligger direkt på data:

{
  "homeScore": 3,
  "awayScore": 1,
  "period": "P2",
  "clock": "12:34"
}

I en CUSTOM-scen finns det däremot både fria lager OCH (om du lagt in ett scoreboard-block) ett scoreboard-objekt under data.scoreboard. Här används en SMART AUTO-MAPPNING (fuzzy match) så att dina text-lager automatiskt får rätt värde:

{
  "scoreboard": { "homeScore": 3, "awayScore": 1, "period": "P2" },
  "layers": [
    { "type": "text", "name": "Hemma poäng (live)", "text": "0" },
    { "type": "text", "name": "Periodvisare",       "text": "" }
  ]
}

När du ändrar scoreboard.homeScore (t.ex. via en +1-knapp) skannar systemet alla text-lager: hittar det att lagrets namn innehåller en känd 'fragment-nyckel' så skrivs värdet in i lagrets text. Matchningen är CASE-INSENSITIV och bortser från mellanslag, bindestreck och svenska tecken (å→a, ä→a, ö→o).

Här är hela mappningen som körs i dag:

Sammanfattning för knappar:

1. Klicka 'Stream Deck' uppe till höger i kontrollpanelen.
2. Skapa en token (en räcker per Stream Deck — håll den hemlig).
3. Välj vilken scen URL:erna ska peka mot.
4. Kopiera valfri URL från listan.
5. I Stream Deck: lägg till knapp av typen 'Website' (System → Open).
6. Klistra in URL:en. Aktivera 'Access in background' så att inget fönster poppar upp.

Tillgängliga åtgärder: poäng +/−, klocka start/stop/reset/justera/sätt, period, scen visa/dölj/toggla/solo, lower-third sätt text, ticker sätt/lägg till/töm/hastighet.

https://din-domän.se/api/control?token=XXX&action=score-home-plus&scene=Match

• Program-output: /overlay/program?workspace=WORKSPACE_ID — den enda URL du behöver i OBS.
• Allt du markerar som 'On Air' i kontrollpanelen staplas live på samma Browser Source.
• För enstaka delningar finns även /overlay/program?token=DELNINGSTOKEN (visar bara den delade scenen).

Rekommenderad upplösning: 1920x1080. Bakgrunden är transparent — sätt CSS i OBS till 'transparent' om det behövs.

• Overlay visar inget i OBS: kolla att scenen är synlig (öga-ikonen) i kontrollpanelen.
• Klockan rör sig inte: tryck Start. Den startar inte automatiskt.
• Stream Deck-knapp gör inget: kontrollera att tokenet inte är raderat och att scennamnet matchar.
• Realtime-uppdateringar laggar: ladda om OBS Browser Source en gång (Refresh cache).

• 2026-04-25 — Ny manual-sektion: Scen-data vs. lagernamn — full jämförelsetabell + fuzzy match-mappning för custom-scener.
• 2026-04-25 — Egen kontrollpanel på /program: drag-drop-knappar, högerklick för redigera/ta bort.
• 2026-04-25 — Realtime broadcast direkt från databasen till overlay (lägre latens än polling).
• 2026-04-25 — Manualen utökad med fältreferens för scen-data (scoreboard, lower-third, bug, ticker, lineup).
• 2026-04-20 — Användarmanual släppt.
• 2026-04-20 — Stream Deck-integration via URL-knappar (alla actions).
• 2026-04-20 — Klock-snabbjustering (±1s, ±10s) och presets (45:00, 90:00).
• 2026-04-20 — Redigera lagnamn, kortnamn och period direkt från scoreboard-blocket.