Skip to content

README.cs.md

Latest commit

 

History

History
165 lines (125 loc) · 8.12 KB

README.cs.md

File metadata and controls

165 lines (125 loc) · 8.12 KB
Raw

MediaMTX Connect

Webové rozhraní pro MediaMTX.
Sledujte živé streamy, procházejte nahrávky, upravte libovolný konfigurační klíč — přímo v prohlížeči.

CI Release Docker MIT

MediaMTX Connect — mřížka živých streamů, prohlížeč nahrávek a editor konfigurace
🌍 Číst ve 30 jazycích

🇺🇸 English • 🇪🇸 Español • 🇨🇳 中文 • 🇮🇹 Italiano • 🇩🇪 Deutsch • 🇷🇺 Русский • 🇫🇷 Français • 🇵🇹 Português • 🇯🇵 日本語 • 🇵🇱 Polski • 🇰🇷 한국어 • 🇹🇷 Türkçe • 🇳🇱 Nederlands • 🇨🇿 Čeština • 🇹🇼 繁體中文 • 🇧🇷 Português (BR) • 🇮🇩 Bahasa Indonesia • 🇷🇴 Română • 🇸🇪 Svenska • 🇩🇰 Dansk • 🇳🇴 Norsk • 🇫🇮 Suomi • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা

Co to je

MediaMTX je vynikající streamovací server bez rozhraní. Connect je chybějící front-end: jeden kontejner, který mluví s API MediaMTX a promění ho v kamerovou stěnu, archiv nahrávek a editor konfigurace.

Je to společník, ne náhrada. Každá obrazovka stojí na něčem, co MediaMTX už vystavuje: na path, endpointu API, hooku runOn*, protokolu, který nativně obsluhuje. Neukládá video, nepřeposílá média, nemá databázi.

Rychlý start

Multiarchitekturní image (linux/amd64, linux/arm64) — Docker stáhne tu správnou.

MediaMTX už běží? Postavte Connect vedle něj:

docker run -d \
  -p 3000:3000 \
  -e BACKEND_SERVER_MEDIAMTX_URL=http://<your-mediamtx-host> \
  -v /path/to/recordings:/recordings \
  -v mediamtx-connect-data:/data \
  bcanfield/mediamtx-connect:latest

Začínáte od nuly? Přiložený compose zvedne oba:

git clone https://github.com/bcanfield/mediamtx-connect.git
cd mediamtx-connect
docker compose up -d

Pak otevřete http://localhost:3000.

Important

Connect potřebuje api: yes ve vašem mediamtx.yml. Přiložená konfigurace funguje tak, jak je.

Co dostanete

Živý pohled

Všechny path, které MediaMTX zná, v mřížce o 2 až 4 sloupcích.

  • WebRTC nebo HLS, pro každou kartu. AUTO tiše spadne na HLS, LOW-LAT trvá na WebRTC, COMPAT vynutí HLS — a každá karta hlásí transport, který opravdu dostala.
  • Snímky i v nečinnosti. Úloha na pozadí drží na každé kartě čerstvý snímek a na štítku jeho stáří.
  • Živá telemetrie. Kodeky, počet diváků a doba běhu, rovnou ze seznamu path.
  • Poctivý stav nahrávání. Karty ukazují, jestli stream skutečně nahrává; stav, který Connect nepřečetl, je neznámý, nikdy vypnutý.
  • Publikační adresy do schránky. RTSP, RTMP a SRT, složené z vlastních naslouchacích adres serveru.

Nahrávky

  • MP4 každého streamu, seskupené po dnech, s automatickými náhledy.
  • Přehrávač, který se rozbalí na místě, převíjitelný přes HTTP Range požadavky.
  • Streamované stahování s živým průběhem a zrušením.
  • Stiskněte / a filtrujte.

Konfigurace bez YAML

  • Celá konfigurace serveru — 65 typovaných a validovaných ovládacích prvků napříč Logging, API, Hooks, RTSP, RTMP, HLS, WebRTC a SRT.
  • Path defaults a overridy pro jednotlivé path, v rozsazích, ze kterých je MediaMTX obsluhuje. Uložení streamu krytého zástupným znakem zapíše řídký záznam, takže nedotčené klíče dál dědí.
  • Všech 15 hooků runOn*, s varováním tam, kde uložení restartuje path.
  • Řídké zápisy — jen klíče, které jste změnili.

Provoz

Jediný proces pro API, SPA i média · multiarchitektura · GET /health · strukturované logy · PWA · světlý i tmavý · 30 jazyků · žádná databáze.

Proměnné prostředí

Naplní jen první start. Dál je vše měnitelné v Config.

Proměnná Výchozí K čemu je
BACKEND_SERVER_MEDIAMTX_URL http://mediamtx Kde Connect dosáhne na API MediaMTX zevnitř svého kontejneru
MEDIAMTX_API_PORT 9997 Port API MediaMTX
MEDIAMTX_RECORDINGS_DIR ./recordings Cesta na hostiteli připojená pro nahrávky (jen compose)
MEDIAMTX_SCREENSHOTS_DIR /screenshots Kam se ukládají náhledy

http://mediamtx se přeloží jen v síti přiloženého compose — pro samostatný docker run nastavte vlastního hostitele.

Jak to funguje

Browser ──HLS / WebRTC (WHEP)──────────────────────────┐
   │                                                   │
   │ oRPC (typed)                                      ▼
   ▼                                              ┌──────────┐
┌─────────────────────┐    MediaMTX HTTP API      │ MediaMTX │
│ mediamtx-connect    │ ────────────────────────▶ │  server  │
│ Hono API + React SPA│                           └──────────┘
└─────────────────────┘                                │
   │ reads                                             │ writes
   ▼                                                   ▼
recordings/ + screenshots/  ◀────────────────────  MP4 segments

Přehrávání jde z prohlížeče do MediaMTX. Connect přenáší jen JSON a k tomu nahrávky a náhledy, které čte z disku.

Dokumentace
Funkce Každá vydaná schopnost, routa a procedura
Architektura Jak do sebe díly zapadají
Přispívání Vývojové prostředí, skripty, proces PR
Příklady Kamera Raspberry Pi, falešné streamy pro testy

Přispívání

Issues a PR jsou vítány. pnpm install && pnpm dev vám postaví celý stack i s testovacími daty — zbytek v CONTRIBUTING.md, názvy PR jsou conventional commits. Řídíme se Kodexem chování.

Licence

MIT