---
title: Adding a Source - File
slug: zen-master/adding-a-source-file
docTags:
createdAt: 2024-12-27T16:33:29.221Z
---
Create a Source from a .ts file. The file needs to already exist in the Root folder on the input Broadcaster (Local File option) or at the remote location (URL option).
:::hint{type="info"}
- The default Root folder for Broadcasters created by ZEN Master is currently /zixi/zixi\_broadcaster-centos7-transcoder/files. Manually created Broadcasters may have a different Root folder.
- ZEN Master does not provide a mechanism for uploading and managing files on the server hosting the Broadcaster. There are numerous web-based file managers that can be deployed for remote file management on the server hosting the Broadcaster
:::
## To add a File Source
:::::WorkflowBlock
:::WorkflowBlockItem
In the main navigation, click **Sources**.
:::
:::WorkflowBlockItem
Click **+ Add**.
The **Create New Source selection** window is displayed.
:::
:::WorkflowBlockItem
Click on **File**.
The **Create New File Source** window opens.
:::
:::WorkflowBlockItem
In the **Info** section, in the **Name** field, enter a unique name to identify this Source in the system.
:::
:::WorkflowBlockItem
In the **Tags** field, select one or more of the predefined Tags from the drop-down list.
Tags are used for access control. By selecting a Tag, you are relating this Source to that Tag. Tags are associated with certain roles (through the Users & Roles screen), and roles, in turn, are associated with users and user groups. If you would like to create a new Tag, see [Creating a Tag](docId\:YpM9tw81ap6nq8sTKv4Rd).
:::
::::WorkflowBlockItem
In the **Events Configuration Profile** field, select from the dropdown list the profile that you would like to apply to this Source. By default, the Default profile is applied.
:::hint{type="info"}
*Events Profiles* consist of a series of rules that determine precisely how various types of Events are logged and what results they trigger.
:::
::::
:::WorkflowBlockItem
The Source's location is used to represent it in the proper position in the Map display (see [Maps](docId\:sFZM6JvoRvuigo7X0dNUE)). By default, the location is determined automatically based on the Source's IP. If you would like to manually set the location of the Source (Optional), use the following procedure:
1. Click on the **Edit** icon next to the **Location **field.
A search box is shown below the **Location** field.
2. Enter identifying info for the location (e.g. street address, zip code, coordinates).
Search results are displayed below the search box as you type.
3. Click on the desired location.
The selected location populates the **Location** field.
:::
:::WorkflowBlockItem
If you would like to stream a file from a local drive, skip to step 10. To stream a file using a URL, use the following procedure:
1. In the **Source** section, verify that **URL** is selected (default).
2. In the **URL** field, enter the URL for the .ts file you would like to stream (e.g. [https://example.com/source.ts](https://example.com/source.ts)).
:::
:::WorkflowBlockItem
If you selected the **Use RTP protocol** checkbox, then if you would like to use FEC, then select the **Use Forward Error Correction **checkbox.
:::
::::WorkflowBlockItem
To upload a file from a local drive, use the following procedure:
1. In the **Source** section, select **Local Drive**.
2. In the **File** field, select from the list the desired .ts file you would like to stream. The selected file will be highlighted and displayed under the list.
:::hint{type="info"}
You can sort the files in the list by clicking on the column headings.
:::
::::
:::WorkflowBlockItem
In the **Public Output** field, if you would like to allow access to the stream directly through a supported player, select the **Allow** checkbox.
:::
:::WorkflowBlockItem
If you selected the **Allow** checkbox, then enter a password in the **Password **field to authenticate access to the stream.
:::
::::WorkflowBlockItem
Under **Content Analysis** select one of the following options:
**Full **- select this option if you would like to enable full Content Analysis (CQA), including analysis of the stream's audio and video content, including audio levels, audio silence detection, frozen video detection, and more.
**TR101 Only** - select this option to perform TR101 analysis only (without video and audio content analysis). The analysis can be used to check the integrity of the TS and the most important elements of the stream. The analysis includes priority 1 and 2. To learn more about TR101 analysis see [TR 101 290 Technical Report](https://www.etsi.org/deliver/etsi_tr/101200_101299/101290/01.03.01_60/tr_101290v010301p.pdf).
**None **- no content analysis is enabled.
:::hint{type="info"}
It is generally recommended to enable full Content Analysis unless it is causing technical problems. If Content Analysis is disabled, the system won't detect errors in the video and audio content of the stream and won't generate warnings for such events.
:::
::::
::::WorkflowBlockItem
If you would like to monitor CEA-608 closed captions, select **Monitor CEA-608 **checkbox**.**
:::hint{type="info"}
Monitoring CEA-608 Closed Captions requires using a version 14.4 or newer Broadcaster.
:::
f you would like to monitor CEA-708 closed captions, select **Monitor CEA-708 **checkbox**.**
:::hint{type="info"}
Monitoring CEA-708 Closed Captions requires using a version 14.4 or newer Broadcaster.
:::
::::
::::WorkflowBlockItem
If you would like to disable auto-pull, select the **Disable Auto-Pull** checkbox.
:::hint{type="info"}
Disabling Auto-Pull will lock Channels using this Source to the Source's Ingest Cluster and Targets to the Source's current active Broadcaster. This setting only applies to Pass-Through Channels.
:::
::::
:::WorkflowBlockItem
If Auto-Pull is *enabled*, in the **Auto-Pull Latency \[ms]** field, specify the maximum latency for auto-pull actions. (Default: 1000 ms)
:::
::::WorkflowBlockItem
In the **WebRTC Playback** section, select the desired playback method.
:::hint{type="info"}
WebRTC enables you to monitor the stream via web browsers and mobile applications with real-time communication (RTC). WebRTC needs to be activated independently for each Source in ZEN Master (by default it is disabled).
:::
Select one of the following options:
- **Disabled **- users will not be able to view this Source using WebRTC (default)
- **Pass-Through** - passes the stream through to WebRTC without transcoding. This option *can only be used *if the input stream is already in a WebRTC compliant format (video - H.264 codec with *Baseline *or *Main *profile and no B frames, Audio - Opus codec).
- **Auto **- ZEN Master automatically transcodes the stream using the optimal profile for each specific user. In this option Zixi Broadcaster will decode the video, transforming it into RAW frames, which will be passed to the WebRTC library, where it will be re-encoded for each individual user.
:::hint{type="info"}
Best quality. However, if monitored by multiple users this can consume extensive resources.
:::
- **1080p/720p/480p/360p** - ZEN Master transcodes the stream to a WebRTC compliant profile with the specified resolution. The transcoding is done by Zixi Broadcaster's transcoder.
:::hint{type="info"}
This method requires a Zixi Broadcaster with X264 or Nvidia for transcoding. This method allows many users to monitor the stream without encoding separately for each individual user, which saves CPU capacity. Since there is only one stream version, it is recommended to encode to a low resolution and low bitrate so that the stream will be viewable by all users monitoring the stream.
:::
::::
:::WorkflowBlockItem
Additional SCTE-35 options are available when you expand the **SCTE-35 Manipulation** section:
Here you can:
- Enable SCTE-35 Insertion
- Specify the length of a search window for a NULL packet for SCTE-35 intertion
- Set the SCTE-35 PID
- Remove any existing SCTE-35 messages from the stream
See the **Parameters Table** below for an explanation of these options.
:::
:::WorkflowBlockItem
In the **Initial State** section, select the Disabled checkbox if you would like to disable this Source upon initial configuration.
Select the **Muted** checkbox if you would like to disable error/recovery notifications for this Source upon initial configuration.
:::
::::WorkflowBlockItem
:::hint{type="info"}
You can Enable/Unmute the Source at any time.
:::
::::
:::WorkflowBlockItem
If you would like to adjust the advanced settings, click **Advanced**.
The **Advanced** settings fields are displayed:
:::
:::WorkflowBlockItem
If you would like to track usage for this Source, enter your **Billing Code** details. See [Billing Codes](docId\:lalXJ_N928TeGCPDpBirJ).
:::
:::WorkflowBlockItem
In the **Auto Pull MTU** field, specify the maximum transmission unit (largest data packet that a network-connected device will accept) in bytes for the Auto Pull.
:::
:::WorkflowBlockItem
To set the detection of frozen video, in the **Frozen Video Minimal Duration** field, specify the default minimal duration in seconds of frozen video after which the Broadcaster will trigger a Frozen video alert. Default: 10 seconds. This setting is supported for Broadcaster version 16.3 and higher.
:::
:::WorkflowBlockItem
To set the detection of blank video, in the **Blank Video Minimal Duration** field, specify the default minimal duration in seconds of blank video after which the Broadcaster will trigger a Blank video alert. Default: 10 seconds. This setting is supported for Broadcaster version 16.3 and higher.
:::
:::WorkflowBlockItem
Click **Save**.
:::
:::::
## File Source Configuration Parameters Table
| Parameter | Description |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ***Info*** | |
| Name | Specify a name for the File Source in ZEN Master. |
| Tags | Select one or more of the predefined Tags from the drop-down list.
Tags are used for access control. By selecting an Tag, you are relating this Source to that Tag. Tags are associated with certain roles (through the Users & Roles screen), and roles, in turn, are associated with users and user groups. If you would like to create a new Tag, see [Creating a Tag](https://zixidocumentation.atlassian.net/wiki/spaces/ZMUG/pages/828014604/Creating+a+Tag). |
| Events Configuration Profile | Select from the dropdown list the profile that you would like to apply to this Source. By default, the *Default* profile is applied.
Note: *Events Profiles* consist of a series of rules that determine precisely how various Events are logged and what results they trigger. |
| Location (Optional) | The Source's location is used to represent it in the proper position in the Map display (see [Maps](docId\:sFZM6JvoRvuigo7X0dNUE)). By default, the location is determined automatically based on the Source's IP. Enter identifying info for the location (e.g. street address, zip code, coordinates) and select the desired location from the suggestions that are shown. |
| ***Input*** | |
| Broadcaster | Select from the drop-down list the Broadcaster on which the file is located. |
| Source | Select the source of your .ts file.
Select one of the following options:
* **URL** (default) – stream a .ts file from a URL
* **Local Drive** – stream a .ts file from the Root folder on the input Broadcaster |
| URL (for URL) | Enter the URL for the .ts file you would like to stream
(e.g. https\://example.com/source.ts). |
| File (for Local Drive) | Select from the list the desired .ts file you would like to stream. The selected file must exist in the Root folder on the input Broadcaster.
Note: You can sort the files in the list by clicking on the column headings. |
| *Configuration* | |
| Public Output | If you would like to allow access to the stream directly through a supported player, select the **Allow** checkbox. |
| Password (for Public Output) | If you selected **Allow** in the *Public Output* field, specify a password in this field to authenticate access to the stream. |
| Content Analysis | Select one of the following options:
* **Full** - select this option if you would like to enable full Content Analysis (CQA), including analysis of the stream's audio and video content, including audio levels, audio silence detection, frozen video detection, and more
* **TR101 Only** - select this option to perform TR101 analysis only (without video and audio content analysis). The analysis can be used to check the integrity of the TS and the most important elements of the stream. The analysis includes priority 1 and 2. To learn more about TR101 analysis see TR 101 290 Technical Report.
* **None **- no content analysis is enabled.
**Note**: It is generally recommended to enable full Content Analysis unless it is causing technical problems. If Content Analysis is disabled, the system won't detect errors in the video and audio content of the stream and won't generate warnings for such events. |
| Monitor CEA-608 Closed Captions | If you would like to monitor CEA-608 closed captions, select this checkbox.
Note**:** Monitoring CEA-608 Closed Captions requires using a version 14.4 or newer Broadcaster. |
| Monitor CEA-708 Closed Captions | If you would like to monitor CEA-708 closed captions, select this checkbox.
Note**:** Monitoring CEA-708 Closed Captions requires using a version 14.4 or newer Broadcaster. |
| Disable Auto-Pull | If you would like to disable auto-pull, select this checkbox.
Note: Disabling Auto-Pull will lock Channels using this Source to the Source's Ingest Cluster and Targets to the Source's current active Broadcaster. This setting only applies to Pass-Through Channels. |
| Auto-Pull Latency \[ms] | Specify the desired latency for auto-pull actions. (Default: 1,000 ms) |
| WebRTC Playback | Select the desired playback method.
Note: WebRTC enables you to monitor the stream via web browsers and mobile applications with real-time communication (RTC). WebRTC needs to be activated independently for each Source in ZEN Master (by default it is disabled).
Select one of the following options:
* **Disabled **– users will not be able to view this Source using WebRTC (default)
* **Pass-Through** – passes the stream through to WebRTC without transcoding. This option *can only be used* if the input stream is already in a WebRTC compliant format (video – H.264 codec with *Baseline* or *Main* profile and no B frames, Audio – Opus codec).
* **Auto **– ZEN Master automatically transcodes the stream using the optimal profile for each specific user. In this option Zixi Broadcaster will decode the video, transforming it into RAW frames, which will be passed to the WebRTC library, where it will be re-encoded for each individual user.
Note: Best quality. However, if monitored by multiple users this can consume extensive resources.
* **1080p/720p/480p/360p **– ZEN Master transcodes the stream to a WebRTC compliant profile with the specified resolution. The transcoding is done by Zixi Broadcaster’s transcoder.
Note: This method requires a Zixi Broadcaster with X264 or Nvidia for transcoding. This method allows many users to monitor the stream without encoding separately for each individual user, which saves CPU capacity. Since there is only one stream resolution, it is recommended to encode to a low resolution and low bitrate so that the stream will be viewable by all users monitoring the stream. |
| ***SCTE-35 Manipulation *** | |
| Enable SCTE-35 Manipulation | Select checkbox to enable SCTE-35 Manipulation. |
| SCTE-35 PID | Set the SCTE-35 PID in which the messages will be inserted. |
| Remove Existing SCTE-35 | Remove any existing SCTE-35 messages from the stream. |
| NULL Packet Search Window (ms) | Look for a NULL packet to insert SCTE-35 messages into the stream
* If the stream is **VBR**, set the value to `0` - SCTE-35 messages can be inserted anywhere, and do not need a NULL packet
* If the stream is **CBR**, the downstream receiver *may* need a CBR stream. Inserting the SCTE-35 message into a NULL packet ensures the stream will remain CBR; however, it may delay the insertion of the message up to the length of the search window |
| ***Initial State*** | |
| Disabled | Select this checkbox if you would like to disable this Source upon initial configuration. |
| Muted | Select this checkbox if you would like to disable error/recovery notifications for this Source upon initial configuration. |
| ***Advanced*** | |
| Billing Codes | If you would like to track usage for this Source, enter your **Billing Code** details, see . (Supported for Broadcasters v14.8+) |
| Billing Channel ID | An optional arbitrary string - you can enter anything you want to for your record-keeping. This is **not** related to ZEN Master Channels. |
| Billing Password | Enter the password that corresponds to this billing code. |
| Auto-Pull Billing Code | Specify the maximum transmission unit (largest data packet that a network-connected device will accept) in bytes for the Auto Pull. |
| Auto-Pull Billing Password | Enter the password that corresponds to this auto-pull billing code. |
| Auto Pull MTU (bytes) | Specify the maximum transmission unit (largest data packet that a network-connected device will accept) in bytes for the Auto Pull. |
| Frozen Video Minimal Duration (seconds) | Specify the default minimal duration in seconds of frozen video after which the Broadcaster will trigger a Frozen video alert. Default: 10 seconds. This setting is supported for Broadcaster version 16.3 and higher. For existing sources, you may need to restart the source. |
| Blank Video Minimal Duration (seconds) | Specify the default minimal duration in seconds of blank video after which the Broadcaster will trigger a Blank video alert. Default: 10 seconds. This setting is supported for Broadcaster version 16.3 and higher. For existing sources, you may need to restart the source. |
| Ignore Monitoring PIDs | Ignore PIDs for empty audio streams to prevent false warnings - enter a comma-delimited list of PID numbers that should not be monitored for null content. |