# Assign media source

The following media sources are available:

- [Local file upload](#upload-local-file): Audio file upload from your local computer.
- [Import from URL](#import-from-url): Import audio file hosted on the public web.
- [Stream](#add-stream-url): Provide some live stream or stream from another website.
- [Line input](#add-line-input): For broadcasting from the live studio.
- [M3U playlist](#add-m3u-playlist): Playlist provided on the playout server.

<img src="../../_static/screenshots/dashboard-episode-media-sources.png" alt="Episode Media Sources" width="600" />

## Upload local file

When you opt to upload a file from your local computer, you can simply drag & drop it directly
into the media source area.

The upload kicks off automatically, with its progress displayed. Once uploaded, your file gets
automatically normalized and converted to [`FLAC`](https://en.wikipedia.org/wiki/FLAC) on the AURA
server.

<img src="../../_static/screenshots/dashboard-episode-media-upload-progress.png" alt="Local file upload progress" width="230" />

Once the upload is complete, the file is listed, along with its extracted metadata.

<img src="../../_static/screenshots/dashboard-show-episode-media-file.png" alt="Uploaded file media source" width="600" />

Hovering over the Metadata area reveals additional meta information. Clicking the _pencil icon_ on
the right-hand side allows you to edit the media source. In addition to editing metadata, you can
also delete the media source.

<img src="../../_static/screenshots/dashboard-show-episode-media-edit.png" alt="Edit file media source" width="400" />

This dialog remains consistent across all media sources.

## Import from URL

Enter the URL of a valid media file hosted on the public web.

<img src="../../_static/screenshots/dashboard-show-episode-media-import.png" alt="Import media source via URL" width="500" />

After confirmation, the media file is automatically imported, normalized, and converted to `FLAC`.

Media embedded within a standard web page won't be extracted.

`TODO: Currently CBA media pages are not automatically resolved to the media file. Update as soon this is available.`

## Add stream URL

Input the URL of a valid audio livestream or a streamable media file hosted online.

<img src="../../_static/screenshots/dashboard-show-episode-media-stream.png" alt="Add stream media source" width="500" />

## Add line input

Choose any available studio from the list.

Only studios configured in the radio station administration are displayed. These studios must also
be properly set up as _line-in_ channels on the playout server.

<img src="../../_static/screenshots/dashboard-show-episode-media-line.png" alt="Add line input media source" width="400" />

## Add M3U playlist

Input the relative path to an [M3U playlist](https://en.wikipedia.org/wiki/M3U) to be scheduled.
The purpose of schedling an M3U playlist is the integration of external services.

To utilize an M3U playlist, it must be stored in the `audio/m3u` directory of the _Audio Store_.
As M3U playlists can't be selected directly, you'll need to know the precise name of the playlist
available on the playout server in advance.

Since this is an advanced feature which requires internal knowledge, it is only available to
_Programme Managers_ by default. But this can be changed in via permission management.