> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dwe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# dweOS zu OBS Studio

> Diese Anleitung hilft Ihnen dabei, das Streaming von dweOS zu OBS Studio einzurichten.

<Warning>
  dweOS unterstützt das Streaming zu OBS nicht offiziell. Die folgenden Schritte gelten nur für Linux und Windows.
</Warning>

<Steps>
  <Step title="dweOS prüfen">
    Nachdem Sie die dweOS-Einrichtung durchgeführt haben, fahren Sie mit den nächsten Schritten fort.

    <Note>
      Notieren Sie sich den bzw. die Ports, an die gestreamt wird.
    </Note>
  </Step>

  <Step title="OBS Studio installieren">
    <Card title="OBS Studio herunterladen" icon="video" href="https://obsproject.com/">
      Klicken Sie hier, um OBS Studio für Desktop auf Ihrem Laptop/PC herunterzuladen.
    </Card>
  </Step>

  <Step title="GStreamer installieren">
    <Tabs>
      <Tab title="Für Linux">
        Führen Sie im Terminal aus:

        ```sh theme={null}
        sudo apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools                
        ```

        Installieren Sie ebenfalls die Entwicklungs-Header für die Plugin-Nutzung:

        ```sh theme={null}
        sudo apt install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
        ```
      </Tab>

      <Tab title="Für Windows">
        <Steps>
          <Step title="GStreamer installieren">
            <Card title="GStreamer-Framework herunterladen" icon="stream" href="https://gstreamer.freedesktop.org/download/#windows">
              Klicken Sie hier, um GStreamer für Desktop auf Ihrem Laptop/PC herunterzuladen.

              <Note>
                Achten Sie darauf, die MinGW-Version herunterzuladen, und installieren Sie sowohl Runtime als auch Development.
              </Note>
            </Card>

            <Tip>
              Installieren Sie im Zweifelsfall die 64-Bit-Version, da diese verbreiteter ist.
            </Tip>

            <Warning>
              GStreamer wird automatisch auf dem Laufwerk D installiert, falls Sie mehrere Laufwerke auf Ihrem PC haben. Sie können es bei einer benutzerdefinierten Installation auf das Laufwerk C ändern.

              Wenn Sie es auf dem Laufwerk D installieren, denken Sie beim Einrichten der Umgebungsvariablen unten daran.
            </Warning>
          </Step>

          <Step title="Umgebungsvariablen konfigurieren">
            <Steps>
              <Step>
                Um zu den Umgebungsvariablen zu gelangen, drücken Sie `Win + R`.
              </Step>

              <Step>
                Geben Sie ein:

                ```
                SystemPropertiesAdvanced
                ```

                und drücken Sie `Enter`.
              </Step>

              <Step>
                Klicken Sie auf `Umgebungsvariablen...`.

                <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/system-properties-dialog.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=e43b7911ce525ec2b854c971afa1266b" width="80%" alt="System Properties Dialog" data-path="dwe-os/legacy/images/system-properties-dialog.png" />
              </Step>

              <Step>
                Markieren Sie die Variable `Path` unter `Benutzervariablen`, indem Sie darauf klicken, und klicken Sie dann unter der Box `Benutzervariablen` auf `Bearbeiten…`.

                <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/environment-variables-dialog.png?s=2d7ac09a6778fd1ceafd7a177335a9eb" width="80%" alt="Environment Variables Dialog" data-path="dwe-os/legacy/images/environment-variables-dialog.png" />
              </Step>

              <Step>
                Ein neues Fenster sollte erscheinen und Sie klicken auf `Neu` und fügen einen Pfad zu Ihrem bin-Ordner zur Liste hinzu. In diesem Fall lautet er:

                ```
                C:\gstreamer\1.0\mingw_x86_64\bin
                ```

                Der Pfad zu Ihrem bin kann variieren und kann von dort ermittelt werden, wo Sie GStreamer in den vorherigen Schritten installiert haben.

                <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/environment-variables-dialog-2.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=84f2d6d273839b4a87e6f3346a66014b" width="80%" alt="Second Environment Variables Dialog" data-path="dwe-os/legacy/images/environment-variables-dialog-2.png" />
              </Step>

              <Step>
                Klicken Sie danach in beiden Fenstern auf `OK` und Sie sollten startklar sein!
              </Step>
            </Steps>
          </Step>

          <Step title="Erfolgreich!">
            Sie sollten nun GStreamer eingerichtet und bereit für die nächsten Schritte haben!
          </Step>
        </Steps>

        <Tip>
          Um die GStreamer-Einrichtung zu überprüfen, öffnen Sie `CMD` und führen Sie Folgendes aus:

          ```sh theme={null}
          gst-launch-1.0 --version
          ```

          Dies sollte zu einer Ausgabe wie dieser führen:

          ```sh theme={null}
          gst-launch-1.0 version 1.16.2
          GStreamer 1.16.2
          https://launchpad.net/distros/ubuntu/+source/gstreamer1.0
          ```
        </Tip>
      </Tab>
    </Tabs>
  </Step>

  <Step title="OBS GStreamer-Plugin installieren">
    <Tabs>
      <Tab title="Für Linux">
        <Steps>
          <Step>
            Laden Sie den neuesten Plugin-Build [hier](https://github.com/fzwoch/obs-gstreamer/releases/) herunter.
          </Step>

          <Step>
            Entpacken Sie die `.zip`-Datei und suchen Sie die Datei `obs-gstreamer.so` im Ordner `linux`.
          </Step>

          <Step>
            Suchen Sie in einem anderen Datei-Explorer den Ordner `obs-plugins` oder führen Sie diesen Befehl im Terminal aus, um den Pfad zu ermitteln:

            ```sh theme={null}
            sudo find /usr/lib -name "obs-plugins" -type d
            ```

            <Tip>
              Dies ist wahrscheinlich ähnlich wie `/usr/lib/x86../obs-plugins`.
            </Tip>
          </Step>

          <Step>
            Verschieben Sie die `.so`-Datei in den Ordner `obs-plugins` oder führen Sie im Terminal aus:

            ```sh theme={null}
            sudo mv ~/Downloads/linux/obs-gstreamer.so /usr/lib/x86_64-linux-gnu/obs-plugins/
            ```

            <Warning>
              In diesem Fall liegt der Speicherort meiner `obs-gstreamer.so` unter `~/Downloads/linux/obs-gstreamer.so`. Ersetzen Sie den Pfad durch den, in den Sie die Datei `obs-gstreamer.so` entpackt haben.

              Denken Sie daran, `/usr/lib/x86../obs-plugins` ebenfalls durch den Pfad Ihres `obs-plugin`-Ordners zu ersetzen.
            </Warning>
          </Step>

          <Step>
            Starten Sie OBS Studio neu, sofern es läuft.
          </Step>
        </Steps>
      </Tab>

      <Tab title="Für Windows">
        <Steps>
          <Step>
            Laden Sie den neuesten Plugin-Build [hier](https://github.com/fzwoch/obs-gstreamer/releases/) herunter.
          </Step>

          <Step>
            Entpacken Sie die `.zip`-Datei und suchen Sie die Datei `obs-gstreamer.dll` im Ordner `windows`.
          </Step>

          <Step>
            Suchen Sie in einem anderen Datei-Explorer den Ordner `obs-plugins\64-bit` (oder die Bit-Größe, die Sie installiert haben).

            <Tip>
              Dies ist wahrscheinlich ähnlich wie `C:\Program Files\obs-studio\obs-plugins\64bit`.

              Falls Sie ihn nicht finden können, klicken Sie mit der rechten Maustaste auf Ihre OBS Studio-Verknüpfung auf dem Desktop oder im Startmenü, wählen Sie `Dateipfad öffnen` und navigieren Sie eine Ebene nach oben zum Hauptordner `obs-studio`, in dem Sie den Ordner `obs-plugins` finden.
            </Tip>
          </Step>

          <Step>
            Verschieben Sie die `.dll`-Datei in den Ordner `obs-plugins\64-bit`.

            <Note>
              Windows wird wahrscheinlich nach Administratorrechten fragen, um Dateien nach C:\Program Files zu verschieben. Klicken Sie auf `Fortsetzen` oder `Ja`.
            </Note>
          </Step>

          <Step>
            Starten Sie OBS Studio neu, sofern es läuft.
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Stream einrichten">
    Der Vorgang ist ab hier über die Betriebssysteme hinweg nahezu identisch.

    <Steps>
      <Step>
        Drücken Sie in OBS Studio unter dem Reiter `Sources` die Schaltfläche `+` und fügen Sie eine GStreamer-Source hinzu.

        <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/add-gstreamer.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=39211fa2050be04adcf73369809e8ea8" width="50%" alt="Add GStreamer Source" data-path="dwe-os/legacy/images/add-gstreamer.png" />

        Benennen Sie sie unter `Create new` wie Sie möchten und bestätigen Sie.
      </Step>

      <Step>
        Als Nächstes werden Sie mit einem Fenster wie diesem konfrontiert:

        <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/add-gstreamer-code.png?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=e77c79eb26e7664556f14242431dded0" width="80%" alt="Add GStreamer Code" data-path="dwe-os/legacy/images/add-gstreamer-code.png" />

        Ersetzen Sie im Feld `Pipeline` den vorhandenen Code durch:

        ```sh theme={null}
        udpsrc port=5600 ! application/x-rtp,media=(string)video,clock-rate=(int)90000,encoding-name=(string)H264 ! rtph264depay ! avdec_h264 output-corrupt=false ! videoconvert ! video.
        ```

        <Warning>
          Ersetzen Sie das `5600` in `port=5600` durch den Port, an den von dweOS 2 gestreamt wird.
        </Warning>

        <Note>
          Windows zeigt Ihnen möglicherweise eine Warnung an; in diesem Fall aktivieren Sie OBS bitte für private und öffentliche Netzwerke.

          <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/gstreamer-windows-prompt.jpg?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=6319bd32c55564f834fd1c70f9072b67" width="80%" alt="GStreamer Window Prompt" data-path="dwe-os/legacy/images/gstreamer-windows-prompt.jpg" />
        </Note>
      </Step>
    </Steps>
  </Step>

  <Step title="Zusätzliche Streams hinzufügen">
    Wenn Sie mehr als einen Stream hinzufügen möchten, wiederholen Sie einfach ab Schritt `5`.

    <Warning>
      Denken Sie daran, die Portnummer wie im vorherigen Schritt angegeben zu ersetzen!
    </Warning>

    Weitere Streams sollten im Hauptfenster von OBS erscheinen. Sie können auf die Videoanzeige klicken, um sie nach Ihren Wünschen anzupassen.
    Hier ist ein Beispiel für eine Einrichtung mit 3 exploreHDs!

    <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/gstreamer-setup-example.jpg?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=da82fbd3df7e69a122e13f2bf65a9ae9" alt="GStreamer Setup Example" width="1981" height="1128" data-path="dwe-os/legacy/images/gstreamer-setup-example.jpg" />
  </Step>

  <Step title="Optimierung">
    Um die Einrichtung zu optimieren, navigieren Sie bitte zu `Datei > Einstellungen > Ausgabe`.

    Setzen Sie unter „Ausgabe" den `Output Mode` auf `Advanced`, um auf zusätzliche Einstellungen zuzugreifen.

    Da jede Kamera standardmäßig auf 10 Mb/s Bitrate eingestellt ist, sollten Streaming und Aufnahme dem entsprechen. Bei 3 Kameras sollte eine Streaming- und Aufnahme-Bitrate von mindestens 30 Mb/s eine hohe Qualität liefern.

    <img src="https://mintcdn.com/deepwaterexplorationinc/NrWVR9Qe6FWmBE6d/dwe-os/legacy/images/obs-settings.jpg?fit=max&auto=format&n=NrWVR9Qe6FWmBE6d&q=85&s=32db2daea921d912b7bdbd778c93f3d0" alt="OBS Settings" width="974" height="752" data-path="dwe-os/legacy/images/obs-settings.jpg" />
  </Step>

  <Step title="Erfolgreich!">
    Wunderbar! Sie sollten nun die Streams in OBS Studio konfiguriert sehen.
  </Step>
</Steps>

<Warning>
  Warnung: <br />
  Bei einer 3-Stream-Konfiguration ist diese Einrichtung auf eine leistungsstarke GPU
  angewiesen, um die Videos flüssig auszuführen. Wir haben festgestellt, dass OBS im
  Vergleich zu Discovery erheblich rechenintensiver ist. Stellen Sie sicher, dass Ihr Laptop
  leistungsstark genug ist, um es auszuführen, oder Sie können die Auflösung einiger
  Streams auf 720p reduzieren.
</Warning>