Platforma hostingu radia
bez przerw w sygnale

{ "success": true, "stations": [
  { "stationId": "radio1", "enabled": true, "running": true, "port": 8000 }
]}

Żądanie

{
  "stationId": "radio1",
  "scServConfig": {
    "port": 8000,
    "adminPassword": "haslo-admina",
    "sourcePassword": "haslo-source",
    "streamTitle": "Radio Przykład",
    "maxListeners": 100,
    "publicServer": "never",
    "authhash": ""
  },
  "autopilotConfig": {
    "bitrate": 128, "crossfade": 2, "xfadeThreshold": 10,
    "shuffle": true, "djMode": "duck", "djDuck": 0.15, "djFade": 1.5,
    "serverType": "shoutcast", "diskQuotaMB": 5000,
    "archive": { "enabled": false, "keepDays": 14 },
    "outputs": []
  }
}

Odpowiedź

{ "success": true, "stationId": "radio1", "token": "…" }

Pola scServConfig

Pola autopilotConfig

{ "success": true, "stationId": "radio1",
  "processes": { "scServ": { "running": true, "pid": 16212 },
                 "autopilot": { "running": true } },
  "meta": { "scServConfig": { … }, "autopilotConfig": { … } },
  "publicStreamBase": "https://domena/s" }

publicStreamBase ustawia setup-ssl.sh — panel buduje z tego link po HTTPS.

{ "scServConfig": { … }, "autopilotConfig": { … } }

Oba pola opcjonalne. Zmiany w scServConfig wymagają restartu stacji. Walidacja haseł jak przy tworzeniu.

tylko owner / master

Usuwa konfigurację. Pliki mediów zostają na dysku.

tylko owner / master

{ "success": true, "scServ": { "pid": 16212 }, "autopilot": { "running": true } }

Sekwencja: sprzątnięcie osieroconych procesów → spawn sc_serv → czekanie do 6 s na gotowość → start pipeline'u i autopilota.

Słuchacze tracą połączenie.

{ "success": true, "diag": {
  "ok": false, "platform": "win32", "arch": "x64", "port": 8000,
  "checks": [
    { "name": "Binarka sc_serv", "ok": true,  "detail": "C:\\…\\bin\\sc_serv.exe" },
    { "name": "Plik konfiguracji", "ok": true, "detail": "…/sc_serv.conf" },
    { "name": "Osierocony sc_serv", "ok": false,
      "detail": "pid 16212 z poprzedniej sesji trzyma port",
      "hint": "Restart agenta sprzątnie go automatycznie" }
  ]
}}

Każdy nieudany punkt ma hint z konkretną instrukcją naprawy.

:type = sc_serv | sc_w3c | sc_serv_process

{ "success": true, "tokens": {
  "owner":  "…", "editor": "…", "viewer": "…"
}}

tylko owner / master

{ "success": true, "autopilot": {
  "running": true,
  "currentTrack": "/…/media/utwor.mp3",
  "trackElapsedSec": 47,
  "trackDurationSec": 213,
  "queue": ["/…/next1.mp3", "/…/next2.mp3"],
  "queueLength": 24,
  "activePlaylist": "main",
  "currentEvent": { "name": "Poranek", "type": "block" },
  "liveDj": { "name": "maciek", "priority": 5, "since": "2026-07-23T08:12:00Z" },
  "overlayActive": false,
  "manualRelay": null,
  "pipeline": { "outputs": [
    { "name": "out1-mp3-128k", "type": "shoutcast",
      "connected": true, "bytesOut": 8412300 }
  ]}
}}

queue zawiera 10 najbliższych pozycji — używane przez voice tracking do wyboru miejsca wstawki.

{ "tracks": ["/pełna/ścieżka.mp3"], "next": true }

next: true — zaraz po bieżącym utworze. false — na koniec kolejki.

{ "tracks": ["/…/voicetrack.webm"], "index": 2 }

{ "success": true, "index": 2, "queueLength": 25 }

index: 0 = zaraz po bieżącym utworze. Podstawa voice trackingu.

{ "url": "https://www.youtube.com/watch?v=…" }
{ "url": "http://inne-radio:8000/stream" }

Linki YouTube / SoundCloud / Twitch agent rozwiązuje przez yt-dlp do bezpośredniego strumienia audio. Działa też z transmisjami na żywo. Zwykły film po zakończeniu oddaje antenę playliście.

{ "success": true, "ok": true, "version": "2026.07.01" }
{ "success": true, "ok": false }

{
  "defaultPlaylist": "main",
  "events": [ … ],
  "rotations": { … }
}

defaultPlaylist przyjmuje nazwę playlisty albo rotation:nazwa.

Pasmo czasowe

{ "name": "Poranek", "playlist": "poranna",
  "startTime": "06:00", "endTime": "10:00",
  "days": [1,2,3,4,5], "priority": 1 }

days: 0 = niedziela … 6 = sobota; brak pola = codziennie. Okna przez północ (22:00–02:00) działają. Przy nakładaniu wygrywa wyższy priority.

Relay o czasie

{ "type": "relay", "name": "Wiadomości", "url": "http://…:8000/;",
  "startTime": "18:00", "endTime": "18:30", "days": [1,2,3,4,5] }

Spot punktowy

{ "type": "spot", "name": "Hejnał", "file": "/…/hejnal.mp3",
  "startTime": "12:00", "mode": "queue" }

mode: queue = po bieżącym utworze, now = natychmiast z fade.

Co godzinę

{ "type": "spot", "name": "Dżingiel", "file": "/…/jingiel.mp3",
  "hourly": true, "minute": 0, "mode": "queue" }

Rotacje

"rotations": {
  "standard": {
    "template": [
      { "category": "muzyka", "count": 3,
        "filters": { "genre": "rock", "yearFrom": 2000, "yearTo": 2020,
                     "ratingMin": 3, "durMin": 120, "durMax": 360,
                     "tagsAny": "hit,lato" } },
      { "category": "jingle", "count": 1, "ignoreRules": true }
    ],
    "rules": {
      "trackNoRepeatMin": 240,
      "artistSepMin": 60,
      "titleSepMin": 120,
      "albumSepMin": 45,
      "sameTimeWindowMin": 60
    },
    "relatedArtists": { "Anna Nowak": ["Ania N.", "A. Nowak"] },
    "cycles": 12
  }
}

Przy braku materiału spełniającego reguły generator schodzi łagodnie — wybiera utwór najdawniej grany zamiast przerywać.

{ "success": true, "tracks": ["/…/a.mp3", "/…/b.mp3"] }

{ "tracks": ["/…/a.mp3", "/…/b.mp3"] }

Zapisuje całą listę — to również sposób na zmianę kolejności. Format na dysku: playlists/<name>.lst, jedna ścieżka na linię.

{ "path": "/…/c.mp3" }

Parametr ?type=media

multipart/form-data, pole files — wiele plików naraz. Parametr ?type=media.

Dozwolone: .mp3 .aac .ogg .flac .wav .m4a .opus .webm

{ "success": true, "files": [
  { "name": "utwor.mp3", "size": 5242880,
    "relativePath": "media/utwor.mp3",
    "fullPath": "/opt/scscript/stations/station_radio1/media/utwor.mp3" }
]}

Limit wielkości: MAX_FILE_SIZE_MB (domyślnie 300).

?type=media&name=x.mp3

?name=x.mp3

{ "deep": true, "force": false }

Skan deep analizuje dźwięk jednym przebiegiem ffmpeg i zapisuje:

Silnik używa tych danych automatycznie przy odtwarzaniu.

{ "success": true, "scan": { "running": true, "done": 142, "total": 380, "errors": 0 } }

Parametry: ?q= (szukajka) &limit=&offset=

{ "success": true, "total": 380, "rows": [ { "file": "…", "artist": "…", "title": "…", "gain_db": -2.3, … } ] }

?file=/pełna/ścieżka.mp3

{ "file": "/…/utwor.mp3",
  "artist": "…", "title": "…", "album": "…", "year": 2019,
  "genre": "pop", "rating": 4, "tags": "hit,lato",
  "cue_start": 1.9, "cue_end": 210.4, "mix_point": 205.0, "gain_db": -2.3,
  "enabled": true,
  "daypart_from": 6, "daypart_to": 22,
  "date_from": "2026-12-01", "date_to": "2026-12-31" }

Parametry: ?from=2026-07-01&to=2026-07-31&type=list|playcount&format=json|csv

type=list — każde odtworzenie z godziną. playcount — zliczenia per utwór. CSV otwiera się w Excelu z polskimi znakami.

{ "success": true, "djs": [ { "name": "maciek", "priority": 5, "enabled": true } ] }

{ "name": "maciek", "password": "tajne123", "priority": 5, "enabled": true }

Jak łączy się DJ (BUTT / Mixxx)

Wyższy priority wypycha niższego z anteny.

{ "password": "…", "priority": 9, "enabled": false }

Autopilot wraca natychmiast.

{ "text": "Słuchasz Radia Przykład", "duck": 0.25, "gain": 1.0 }

duck — głośność podkładu pod głosem (0–1). Silnik: piper (lepszy głos, wymaga PIPER_MODEL) z fallbackiem na espeak-ng.

Jednocześnie może grać tylko jedna zapowiedź — kolejna dostaje 400.

{ "duck": 0.25 }

{ "success": true, "text": "Jest godzina dwudziesta pierwsza trzydzieści" }

Poprawna polska odmiana godzin.

{ "temp": 21, "desc": "słonecznie", "duck": 0.3 }

Odmienia stopnie: stopień / stopnie / stopni.

{ "carts": [
  { "label": "Dżingiel", "file": "/…/jingiel.mp3", "duck": 0.3, "gain": 1.0 }
]}

Maksymalnie 12 padów. W panelu pod klawiszami 1–9.

{ "file": "/…/jingiel.mp3", "duck": 0.3 }

{ "blocks": ["08:00", "12:00", "16:30"],
  "intro": "/…/ads/intro.mp3",
  "outro": "/…/ads/outro.mp3",
  "separator": "/…/ads/sep.mp3",
  "maxBlockSec": 180 }

{ "name": "Promocja lato", "client": "Pizzeria Roma",
  "file": "/…/ads/spot.mp3",
  "type": "gastronomia",
  "priority": 3,
  "dateFrom": "2026-07-01", "dateTo": "2026-07-31",
  "enabled": true,
  "grid": { "08:00": 1, "12:00": 2 } }

{ "id": "a3f9…", "blockTime": "12:00", "count": 2 }

count: 0 usuwa z bloku.

{ "success": true, "plan": [ { "blockTime": "12:00", "spots": 3, "items": 5, "warnings": [] } ] }

Wykrywa: brakujące pliki, wygasłe kampanie, kampanie nieprzypisane do żadnego bloku, dwa spoty tego samego typu pod rząd.

{ "blockTime": "12:00" }

Parametry: ?from=&to=&groupBy=campaign|list&campaignId=&format=json|csv

groupBy=campaign — podsumowanie: ile emisji, łączny czas, pierwsza i ostatnia.

groupBy=list&format=csv — dowód emisji: data, godzina, klient, kampania, blok, długość każdej emisji.

{ "success": true, "enabled": true }

?q=zima — min. 2 znaki

{ "success": true, "results": [
  { "file": "/…/zima.mp3", "artist": "Tomek", "title": "Zima", "duration": 214 }
]}

Zwraca tylko utwory enabled, maksymalnie 15.

{ "file": "/…/zima.mp3", "name": "Ania", "message": "Pozdro dla ekipy" }

{ "success": true, "status": "pending" }
{ "success": true, "status": "queued" }   ← przy autoApprove

Anty-spam: limit zgłoszeń na IP na godzinę + blokada duplikatów w kolejce.

{ "success": true, "pending": [ { "id": "…", "name": "Ania", "file": "…", "message": "…" } ], "stats": { … } }

{ "enabled": true, "autoApprove": false, "maxPerIpPerHour": 3, "playNext": false }

{ "success": true, "nowPlaying": { "currentSong": "Artysta — Tytuł", "listeners": 42, "online": true } }

?limit=20

Server-Sent Events — do widgetu aktualizowanego na żywo.

{ "success": true, "media": {
  "track": { "artist": "…", "title": "…" },
  "cover": "https://… albo /stations/…/nowplaying/cover?f=…",
  "lyrics": { "plain": "…", "synced": "[00:12.30]linia…", "source": "lrclib" },
  "video": { "url": "https://…preview.m4v", "poster": "https://…" }
}}

Źródła po kolei: grafika i tekst osadzone w pliku → iTunes Search API (okładka 600×600, oficjalny 30-sekundowy teledysk) → LRCLIB (tekst, także zsynchronizowany). Wyniki cachowane 30 dni per plik.

?f=nazwa.mp3 → JPEG

{ "success": true, "files": [
  { "name": "2026-07-23_14.mp3", "size": 57802240, "mtime": 1753280000000 }
]}

Włączenie: autopilotConfig.archive = { "enabled": true, "keepDays": 14 }. Pliki godzinowe, starsze niż keepDays kasują się same.

{ "success": true, "settings": {
  "proxy": {
    "publicPanelUrl": "https://radio.domena.pl",
    "publicStreamBase": "https://radio.domena.pl/s"
  },
  "webhook": {
    "enabled": true,
    "url": "https://scscript.pl/api/agent-events",
    "secret": "••••••••",
    "events": { "adPlayed": true, "djOnOff": true, "stationDown": true,
                "nowPlaying": false, "requestNew": false },
    "lastOk": "2026-07-23T12:00:03Z", "lastError": null
  }
}}

Sekret nigdy nie wraca w jawnej postaci — tylko informacja, że jest ustawiony.

{ "proxy": { "publicPanelUrl": "…", "publicStreamBase": "…" },
  "webhook": { "enabled": true, "url": "…", "secret": "…",
               "events": { "adPlayed": true, … } } }

Pola opcjonalne — zapisujesz tylko to, co zmieniasz. Pominięty albo zamaskowany (••••••••) sekret zostawia istniejący bez zmian.

publicStreamBase trafia natychmiast do GET /stations/:id/status — panel i apka zaczynają budować linki https zamiast http://host:port.

{ "success": true, "status": 200, "ms": 33 }
{ "success": false, "error": "HTTP 404 Not Found" }

Wysyła pakiet event: "test" z pełnym podpisem — dobre do sprawdzenia, czy SCScript poprawnie weryfikuje HMAC.

{ "success": true, "ok": false,
  "checks": [
    { "name": "Panel po HTTPS", "ok": false, "detail": "połączenie po http",
      "hint": "Bez HTTPS nie zadziała mikrofon w apce mobilnej…" },
    { "name": "Za reverse proxy", "ok": false, "detail": "brak nagłówków proxy",
      "hint": "Dodaj proxy_set_header X-Forwarded-Proto $scheme;" },
    { "name": "Publiczny adres streamów", "ok": true, "detail": "https://radio.domena.pl/s" },
    { "name": "Certyfikat Let's Encrypt", "ok": false, "detail": "brak w /etc/letsencrypt/live" }
  ],
  "command": "sudo bash deploy/setup-ssl.sh radio.domena.pl twoj@email.pl" }

Wykrywa też niespójność: panel po HTTPS + streamy po HTTP = przeglądarka zablokuje odtwarzanie (mixed content).

{ "success": true, "version": "3.12.0", "uptime": 84213 }

bez tokenu