Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 2.79 KB

README.md

File metadata and controls

69 lines (52 loc) · 2.79 KB
Raw

datarhei Core - Streamfile importer

This Python application (Python 3.10, Core PyClient) demonstrates how to interact with the datarhei Core. The application enables local files to generate FFmpeg processes, which consider the file name and file content (stream URL) and make the corresponding stream URL available as HLS, RTMP, and/or SRT streams.

The application is designed to be responsive to new files, file changes, and file deletions. However, it currently only supports H.264 and AAC live-streams.

Installation steps (Linux/macOS example)

  1. Start the Core and enable the built-in RTMP and SRT servers

    docker run -d --name core \
    --security-opt seccomp=unconfined \
    -p 8080:8080 -p 1935:1935 -p 6000:6000/udp \
    -e CORE_RTMP_ENABLE=true -e CORE_SRT_ENABLE=true \
    datarhei/core:latest

  2. Get the internal CORE_ADDRESS

    docker inspect -f '{{ .NetworkSettings.IPAddress }}' core

    Example: 172.17.0.2

    This allows the application to communicate with the Core. As an alternative, you can also use the IP address of the host system.

  3. Build and start the Streamfile-Importer

    git clone github.com/datarhei/core-streamfile
cd core-streamfile
docker build -t core-streamfile .
docker run -d --name core-streamfile \
    -v $PWD/streamfiles:/streamfiles \
    -e CORE_ADDRESS=http://172.17.0.2:8080 \
    -e PROCESS_OUTPUT_PROTOCOL="hls,rtmp,srt" \
    core-streamfile

  4. Create a streamfile in the streamfiles directory

    echo 'https://demo.datarhei.com/memfs/1f33d538-d714-4c7e-9559-46ddb8118f03.m3u8' > mystream.stream

    The file content (stream url) can be any streaming url such as HTTP, RTSP, RTMP, SRT.

    The default SYNC_INTERVAL_SECONDS is 10.

  5. Check the stream is running

Enviroments

  • CORE_ADDRESS (default: unset)
  • CORE_USERNMAE (default: unset)
  • CORE_PASSWORD (default: unset)
  • PROCESS_OUTPUT_PROTOCOL (default: hls, max: hls,rtmp,srt)
  • PROCESS_REFERENCE (default: streamfile)
  • STREAMFILE_FOLDER (default: /streamfiles)
  • SYNC_INTERVAL_SECONDS (default: 10)

Contributing

We welcome contributions to this project. If you find a bug or have a suggestion for a new feature, please create an issue on the repository's issue tracker. If you would like to contribute code, please fork the repository and create a pull request with your changes.

License

This application is released under the MIT License.