---
title: ZEC Adding File over HTTP Streams
slug: zixi-broadcaster-v18/zec-adding-file-over-http-streams
docTags: 
createdAt: 2024-12-26T19:07:39.951Z
---

This enables you to add a File over HTTP stream, where the source is a file on an HTTP server (e.g. S3) that is copied to a temporary location on the local computer.

**To Add a File over HTTP Stream:**

:::::WorkflowBlock
:::WorkflowBlockItem
In the ZEC Navigation menu, click the **Inputs** tab.
:::

:::WorkflowBlockItem
In the Menu bar, click **New Input**. The **Add a new input stream** window is displayed.
:::

::::WorkflowBlockItem
Enter the unique **Stream ID**.

:::hint{type="info"}
Note this must be identical (case sensitive) to the stream name configured in the sending Zixi Broadcaster or MediaConnect.
:::
::::

:::WorkflowBlockItem
Select the maximum concurrent connections to this stream from the **Max. Outputs** drop-down list. Default: Unlimited.
:::

:::WorkflowBlockItem
Select the **Show in Matrix** check box to display this stream in the Matrix (see [ZEC Using the Matrix](docId\:nlXzEHz-9RxLcmX6xIe_c)). Default: Selected.
:::

:::WorkflowBlockItem
Select **File over HTTP&#x20;**&#x66;or the input stream.



![File over HTTP Input](https://api.archbee.com/api/optimize/yloo8L9Y5DmjuuW_iCtAX-Lm-KOk_MQFQLxylvSNOu8-20250302-161037.png)
:::

:::WorkflowBlockItem
Specify the **Stream Parameters** (see the Input Stream Parameter Table below).
:::

:::WorkflowBlockItem
If you want to **Enable encryption**, select this checkbox (see Input Stream Parameters Table). For more information, see [ZEC Encrypting an Input Stream](docId\:NmS0u6UROxUZMoZp2he_L) .
:::

:::WorkflowBlockItem
If you want to configure the **Recording Parameters**, specify them in the respective fields (see Input Stream Parameter Table)
:::

:::WorkflowBlockItem
Click **OK**.
The “Input added” message appears on the top of the screen.&#x20;
:::
:::::

## Input Stream Parameters Table

| **Parameter**                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Stream parameters**                                    | <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **URL**                                                  | Specify the URL for the File over HTTP stream.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **URL for HEAD request**                                 | When receiving the file, there is usually first a HTTP HEAD request, just to get the size of the file, and then an HTTP GET request to get the file itself. However, you may want to use a different URL for the HEAD request. If so, specify the separate URL for the HEAD request only.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Ignore HEAD request**                                  | Select this option to ignore any errors when making HEAD request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Enable Encryption**                                    | Select this checkbox to encrypt the Input stream. For more information, see [ZEC Encrypting an Input Stream](docId\:NmS0u6UROxUZMoZp2he_L) .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Encryption type (for Encryption enabled)**<br /><br /> | Specify the type of Encryption (AES 128/192/256).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Encryption key (for Encryption enabled)**              | Click **Generate** to generate an encryption key. The generated encryption key must be sent to the end-user to decipher the received encoded stream.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ***Recording parameters***                               | Select this checkbox to customize the recording parameters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ***Destination Type***                                   | Select the radio button for the desired storage type and then fill in the relevant parameters.<br />- **Record to disk** – the recording is saved on the local disk. It is possible to record to an external destination by replacing the default storage location with a symbolic link. To learn more, see [ZEC Using an External Storage](docId:8MiL85ijafynOUTwWOuQi)  section.<br />- **Record to S3** – the file is saved to your AWS S3 Bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ***Record to Disk Parameters***                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **File Name Template**                                   | Specify the file name pattern that Zixi will use to generate when saving the recorded content. A separate file will be generated for each recording up to the time specified in the Max recorded file duration parameter (see above). After this duration a new file will be generated.<br />The file name pattern can include any string and up to five variables listed below. Only the %T=HH.MM.SS creation time is mandatory. You can change the order of these variables and add text as long as you maintain the legitimate structure of the file in Linux and Windows:<br />- %S=stream id - optional.<br />- %Y=year - optional<br />- %M=month - optional<br />- %D=day - optional<br />- %T=HH.MM.SS creation time - mandatory<br />- %U=YYYYmmddTHHMMSSZ UTC timestamp – optional<br />For example, the following pattern %Y\_recording%T.ts will generate the following file name 2022\_recording15:32:35.ts. |
| **Max recorded file duration \[hours]**                  | Specify the maximum time allotted for recording a video stream. Default: 2 hours                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Keep recorded files for \[hours]**                     | Specify the maximum time for storing the recording. Default: 0 hours                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Custom Path**                                          | Optionally specify a storage location for the recorded files that is relative to the root folder. This location bypasses the location specified as the root folder in the **Settings** > **General&#x20;**&#x73;creen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ***Record to S3 Parameters***                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **File Name Template**                                   | Specify the file name pattern that Zixi will use to generate when saving the recorded content. A separate file will be generated for each recording up to the time specified in the Max recorded file duration parameter (see above). After this duration a new file will be generated.<br />The file name pattern can include any string and up to five variables listed below. Only the %T=HH.MM.SS creation time is mandatory. You can change the order of these variables and add text as long as you maintain the legitimate structure of the file in Linux and Windows:<br />- %S=stream id - optional.<br />- %Y=year - optional<br />- %M=month - optional<br />- %D=day - optional<br />- %T=HH.MM.SS creation time - mandatory<br />- %U=YYYYmmddTHHMMSSZ UTC timestamp – optional<br />For example, the following pattern %Y\_recording%T.ts will generate the following file name 2022\_recording15:32:35.ts. |
| **Max recorded file duration \[hours]**                  | Specify the maximum time allotted for recording a video stream. Default: 2 hours                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **URL**                                                  | Specify the URL of the S3 bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Ignore TLS certificate errors**                        | TLS certificate for S3 bucket might be detected as faulty if bucket name contains dot\[s]. When this option is selected, ZEC will ignore the TLS certificate errors and transmit the stream to its destination.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Access Key**                                           | The access key that is used for accessing the S3 bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Secret Key**                                           | The secret key that is used for accessing the S3 bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

