GITBOOK-157: update mainsail webcam settings

overview/settings/webcams.md

@@ -1,37 +1,19 @@
-# Webcams
-
-## Prerequisites
-
-### MJPEG
-
-To be able to add a stream to Mainsail, it must be available as a so-called “MJPEG stream”.
-
-So either you have a network camera that offers such a stream by itself, or you use a conventional webcam (USB camera, Raspberry Pi Camera, …) that is connected to your system. For a non-network cameras, you need to install and configure a streamer software on your system, such as [Crowsnest](http://127.0.0.1:5000/o/O2j4rN2JOaGEeS1KBjXz/s/qXE1OQLsr0XFNbT54RTY/). 
-
-{% hint style="info" %}
-[MainsailOS ](http://127.0.0.1:5000/o/O2j4rN2JOaGEeS1KBjXz/s/HZGYoL7ogomNyBLNEpEJ/)comes preinstalled with [Crowsnest](http://127.0.0.1:5000/o/O2j4rN2JOaGEeS1KBjXz/s/qXE1OQLsr0XFNbT54RTY/) as streamer. If you wish to install Crowsnest on your system, or need assistance in configuring Crowsnest, please refer to its documentation.
-{% endhint %}
-
-Once such a stream is available, you only have to configure it in the Mainsail settings. 
-
-### IP Cam
+---
+description: >-
+  In this tab you can connect mainsail with different webcam streamers. Some of
+  the webcam clients are provided by Crewsnest (Webcam streamer wrapper from the
+  Mainsail-Crew).
+---
 
-The stream of your IP camera needs to be compatible with your browser. More information:
-
-[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video)\
-[https://www.w3schools.com/tags/tag\_video.asp](https://www.w3schools.com/tags/tag\_video.asp)
-
-## Settings
-
-Go to the [settings](./) and select the Webcam category.
+# Webcams
 
-In this view, you can add new webcams, or edit and remove existing ones.
+Go to the [settings](./) and select the Webcam category. In this view, you can add new webcams, or edit and remove existing ones.
 
-![](../../.gitbook/assets/grafik.png)
+![Webcam Settings](../../.gitbook/assets/grafik.png)
 
 While adding or editing a webcam, you will see the following screen.
 
-\[Insert Image....]
+<figure><img src="../../.gitbook/assets/image (9).png" alt=""><figcaption><p>Add new webcam form</p></figcaption></figure>
 
 ### Preview
 
@@ -41,26 +23,34 @@ On the right side, you can check the settings in a preview.
 
 At first, you have to give the camera a name, and you can assign an icon to it.
 
-### Streaming URLs
+### Stream & Snapshot URLs
 
 You also need to specify stream and snapshot URL. For network cameras, please consult the manufacturer's manual or search the Internet.
 
 **Note:** In [MainsailOS](http://127.0.0.1:5000/o/O2j4rN2JOaGEeS1KBjXz/s/HZGYoL7ogomNyBLNEpEJ/), by default, four webcam ports are mapped to URLs. Notice that the first URL doesn't contain a number. Check which port you have configured in your streamer and add the URLs.
 
 <table><thead><tr><th width="150">Port</th><th>Stream URL</th><th>Snapshot URL</th></tr></thead><tbody><tr><td>8080</td><td>/webcam/?action=stream</td><td>/webcam/?action=snapshot</td></tr><tr><td>8081</td><td>/webcam2/?action=stream</td><td>/webcam2/?action=snapshot</td></tr><tr><td>8082</td><td>/webcam3/?action=stream</td><td>/webcam3/?action=snapshot</td></tr><tr><td>8083</td><td>/webcam4/?action=stream</td><td>/webcam4/?action=snapshot</td></tr></tbody></table>
 
-### Streaming mode
+### Service
 
 You also need to select a streaming mode. Below are descriptions of the different modes, so you can decide. Try out what works best for you.
 
-<table><thead><tr><th width="213.55085622344592">Mode</th><th>Description</th></tr></thead><tbody><tr><td><strong>MJPEG-Streamer</strong></td><td><p>The streamer mode extracts individual frames from the stream URL and streams them. </p><p></p><p>This is to prevent the buildup of delay in case of insufficient bandwidth. <br><br><strong>IMPORTANT:</strong> This mode does currently not work on iOS devices for technical reasons.</p></td></tr><tr><td><strong>Adaptive MJPEG-Streamer</strong></td><td><p>The adaptive mode takes the snapshot URL and pulls individual images. </p><p></p><p>Also, this is intended to prevent a delay.</p></td></tr><tr><td><strong>UV4L-MJPEG</strong></td><td><p>The classic mode is the plain MJPEG stream embedded in an image tag. </p><p></p><p>In this case, it can happen that after some runtime a delay steadily builds up, because frames cannot be skipped. Only a browser reload will help.</p></td></tr><tr><td><strong>IP-Camera</strong></td><td>The stream URL is embedded in an HTML5 video element. We can't really provide support for this. Browser plugins may be required.</td></tr><tr><td><strong>WebRTC (camera-streamer)</strong></td><td>This stream is very bandwidth efficient.<br><br><strong>IMPORTANT</strong>: This mode is currently only available on Raspberry devices.</td></tr><tr><td><strong>HLS Streamer</strong></td><td>This mode is for IP webcams with RTSP support.</td></tr></tbody></table>
+<table><thead><tr><th width="213.55085622344592">Mode</th><th>Description</th></tr></thead><tbody><tr><td><strong>MJPEG-Streamer</strong></td><td><p>The streamer mode extracts individual frames from the stream URL and streams them. </p><p></p><p>This is to prevent the buildup of delay in case of insufficient bandwidth. <br><br><strong>IMPORTANT:</strong> This mode does currently not work on iOS devices for technical reasons.</p></td></tr><tr><td><strong>Adaptive MJPEG-Streamer</strong></td><td><p>The adaptive mode takes the snapshot URL and pulls individual images. </p><p></p><p>Also, this is intended to prevent a delay.</p></td></tr><tr><td><strong>UV4L-MJPEG</strong></td><td><p>The classic mode is the plain MJPEG stream embedded in an image tag. </p><p></p><p>In this case, it can happen that after some runtime a delay steadily builds up, because frames cannot be skipped. Only a browser reload will help.</p></td></tr><tr><td><strong>IP-Camera</strong></td><td>The stream URL is embedded in an HTML5 video element. We can't really provide support for this. Browser plugins may be required.</td></tr><tr><td><strong>WebRTC (camera-streamer)</strong></td><td>This stream is very bandwidth efficient.<br><br><strong>IMPORTANT</strong>: This mode is currently only available on Raspberry devices.</td></tr><tr><td><strong>WebRTC (MediaMTX)</strong></td><td>This stream is very bandwidth efficient. This mode can also be used for WYZE-Cams with the docker-WYZE-Bridge. Here you can find a tutorial: <a href="http://127.0.0.1:5000/s/qXE1OQLsr0XFNbT54RTY/faq/how-to-use-wyze-cams">LINK</a><br><br><strong>IMPORTANT:</strong> min. v0.23 of MediaMTX</td></tr><tr><td><strong>HLS Streamer</strong></td><td>This mode is for IP webcams with RTSP support.</td></tr></tbody></table>
 
 
 
 ### Target FPS
 
 Only in adaptive MJPEG mode, you also have to set the target frame rate. This is how often per second an image is requested.
 
-### Image Settings
+### Rotate
+
+In some services, you can also rotate the webcam stream.
+
+### Hide FPS counter
+
+Hide the FPS counter in the webcam image.
+
+### Flip Webcam Image
 
 Flip the webcam vertically and/or horizontally. Both at the same time corresponds to a 180° rotation.