Skip to content

Latest commit

 

History

History
165 lines (125 loc) · 8.44 KB

File metadata and controls

165 lines (125 loc) · 8.44 KB

MediaMTX Connect

A MediaMTX webes felülete.
Nézz élő adásokat, böngéssz a felvételek között, szerkeszd bármelyik konfigurációs kulcsot — a böngésződből.

CI Release Docker MIT

MediaMTX Connect — élő adások rácsa, felvételböngésző és konfigurációszerkesztő
🌍 Olvasd el 30 nyelven

🇺🇸 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 • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা

Mi ez

A MediaMTX kiváló streamingszerver, felület nélkül. A Connect a hiányzó front-end: egyetlen konténer, amely a MediaMTX API-jával beszélget, és kamerafallá, felvételtárrá és konfigurációszerkesztővé alakítja.

Társ, nem helyettesítő. Minden képernyő olyasmire épül, amit a MediaMTX már közzétesz: egy path, egy API-végpont, egy runOn* hook, egy natívan kiszolgált protokoll. Nem tárol videót, nem proxyzik médiát, nincs adatbázisa.

Gyors indulás

Többarchitektúrás képek (linux/amd64, linux/arm64) — a Docker a megfelelőt tölti le.

Már fut a MediaMTX? Állítsd mellé a Connectet:

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

A nulláról indulsz? A mellékelt compose mindkettőt elindítja:

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

Utána nyisd meg a http://localhost:3000 címet.

Important

A Connectnek api: yes kell a mediamtx.yml fájlodban. A mellékelt konfiguráció így, ahogy van, működik.

Mit kapsz

Élő nézet

Minden path, amiről a MediaMTX tud, 2–4 oszlopos rácsban.

  • WebRTC vagy HLS, kártyánként. Az AUTO csendben HLS-re vált, a LOW-LAT ragaszkodik a WebRTC-hez, a COMPAT HLS-t kényszerít — és minden kártya azt a szállítást jelenti, amit ténylegesen kapott.
  • Pillanatképek üresjáratban. Egy háttérfeladat friss képkockát tart minden kártyán, a képkocka korával a címkén.
  • Élő telemetria. Kodekek, nézőszám és üzemidő, egyenesen a path-listából.
  • Őszinte felvételi állapot. A kártyák azt mutatják, hogy egy stream ténylegesen rögzít-e; amit a Connect nem tudott kiolvasni, azt ismeretlennek hívja, sosem kikapcsoltnak.
  • Közzétételi URL-ek a vágólapra. RTSP, RTMP és SRT, a szerver saját figyelőcímeiből építve.

Felvételek

  • Minden stream MP4-jei, napokra bontva, automatikus bélyegképekkel.
  • Helyben kinyíló lejátszó, HTTP Range kérésekkel tekerhető.
  • Streamelő letöltések élő haladásjelzővel és megszakítással.
  • Szűréshez nyomj / billentyűt.

Konfiguráció YAML nélkül

  • A teljes szerverkonfiguráció — 65 típusos, validált vezérlő a Logging, API, Hooks, RTSP, RTMP, HLS, WebRTC és SRT szakaszokban.
  • Path defaults és path-onkénti felülbírálások azokon a hatókörökön, ahonnan a MediaMTX kiszolgálja őket. Egy helyettesítő karakterrel lefedett stream mentése ritka bejegyzést ír, így az érintetlen kulcsok tovább öröklődnek.
  • Mind a 15 runOn* hook, figyelmeztetéssel ott, ahol a mentés újraindítja a path-ot.
  • Ritka írások — csak a megváltoztatott kulcsok.

Üzemeltetés

Egyetlen folyamat az API-nak, a SPA-nak és a médiának · többarchitektúrás · GET /health · strukturált naplók · PWA · világos és sötét · 30 nyelv · nincs adatbázis.

Környezeti változók

Csak az első indulást vetik el. A többi a Config alatt marad szerkeszthető.

Változó Alapérték Mire való
BACKEND_SERVER_MEDIAMTX_URL http://mediamtx Hol éri el a Connect a MediaMTX API-t a konténerén belülről
MEDIAMTX_API_PORT 9997 A MediaMTX API portja
MEDIAMTX_RECORDINGS_DIR ./recordings A felvételekhez csatolt hoszt-útvonal (csak compose)
MEDIAMTX_SCREENSHOTS_DIR /screenshots Hová kerülnek a bélyegképek

A http://mediamtx csak a mellékelt compose hálózatán oldódik fel — önálló docker run esetén add meg a saját hosztodat.

Hogyan működik

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

A lejátszás a böngészőből a MediaMTX-hez megy. A Connect csak JSON-t mozgat, plusz a lemezről olvasott felvételeket és bélyegképeket.

Dokumentáció

Funkciók Minden kiadott képesség, útvonal és eljárás
Architektúra Hogyan illeszkednek a darabok
Közreműködés Fejlesztői környezet, szkriptek, PR-folyamat
Példák Raspberry Pi kamera, hamis streamek teszteléshez

Közreműködés

A hibajegyeket és PR-eket szívesen fogadjuk. A pnpm install && pnpm dev teljes stacket ad tesztadatokkal — a többit lásd a CONTRIBUTING.md fájlban, és a PR-címek conventional commits formátumúak. Magatartási kódexet követünk.

Licenc

MIT