> For the complete documentation index, see [llms.txt](https://gsfcorp.gitbook.io/macula/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gsfcorp.gitbook.io/macula/operation-quick-guides/macula-stream-mobile-camera.md).

# Macula Stream Mobile Camera

1. Go to Macula server configuration via Macula Console, go to the Configuration section and choose Devices from the menu on the left.
2. On the upper panel, click the + New device button in order to create a new device; enter your desired name and set the Model to (Generics) - External Source, then save. 

{% hint style="info" %}
Note the value appearing in the Code field: you will need to enter it into your app.
{% endhint %}

3. Next, go to your app -> tap *Settings* in the bottom, find *Device Camera* in the list and choose your video preferences; the contents of each item may vary depending on your mobile device capabilities:

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FnPbnKVjc77X2rEjCcMdT%2Fimage.png?alt=media&amp;token=5494ac76-f238-4c1a-b887-1ea4661067c3" alt="" width="443"><figcaption><p>Macula Mobile - Device camera</p></figcaption></figure>

**Device Camera**:

* **Camera:** Configure camera: select which camera to use (primary/secondary), set Codec, Resolution, Bitrate, FPS, and microphone.&#x20;
* **Detect cameras**: Use this if no cameras are shown in the camera menu item.&#x20;
* **GPS**: Stream device location with video to server (on/off).&#x20;
* **Store offline video**: You can pick from the list where to save offline video.
* **Offline video storage limit**: pick from the list how much memory you want to allow for online video.&#x20;
* **When no space left**: You can decide to overwrite the oldest video or just stop the recording.&#x20;
* **Default video upload server**: Select to which server to upload the recorded offline videos.

4. After the camera is set for the streaming - you can start streaming to the server by selecting Server from the *Server* list, then go to the top-left "hamburger" menu and select *Stream camera*.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2F14GrRAMTcJpJhMmDEzcb%2Fimage.png?alt=media&amp;token=bb0a50fe-514a-495c-a653-6457c5e11100" alt="" width="327"><figcaption><p>Stream camera</p></figcaption></figure>

5. You will see the video stream preview and the round button in the bottom-middle part of your device screen. Tap this button and the video will be streamed to the server.&#x20;

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FZH7CLFKH108Y1bFnxaSv%2Fimage.png?alt=media&amp;token=9e793227-a439-4850-be51-e677a1c1a814" alt=""><figcaption><p>Stream video button</p></figcaption></figure>

6. Enter the Code/registration token from step 2.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FDzUU2f8aO6HNfO5cHeOf%2Fimage.png?alt=media&amp;token=df3f83b8-54ef-4232-a079-5475d12514b0" alt=""><figcaption><p>Enter regustration token</p></figcaption></figure>

{% hint style="info" %}
For Android 6.0 and newer, you may need to go to your mobile device's system permissions and explicitly allow Macula Mobile to use the camera in case you were not asked for this permission or if you have chosen to deny access to this component.
{% endhint %}

5. The button will change its appearance to the red dot "recording" button.&#x20;
6. To stop streaming tap on this button.