z9gege / free-hls-live

Free live streaming with Free-HLS (Free HLS 直播姬)

Free HLS Live

Free live streaming with Free-HLS.

Read this in other languages: English | 简体中文

This project is for learning and communication purposes only, and we are not responsible for any losses caused to you or others during use.

Requirements

• Node.js
• Yarn
• Aliyun OSS / TencentCloud COS

Installation

git clone https://github.com/sxzz/free-hls-live.git
cd free-hls-live
yarn install

Usage

First, you need to write an Uploader by yourself, see sxyazi/free-hls#19

Configure Storage

Because the m3u8 file is constantly changing, it cannot be implemented with the image bed

You need to have a service that can store files and can be accessed by the public network, such as servers, Aliyun OSS, TencentCloud COS, etc. And you need to configure CORS cross-domain. The m3u8 file is generally small and cost less.

Copy config.example.yml to config.yml

Via OBS

1. In the settings dialog go to Advanced and set the recording filename. The default includes the current time. Choose something without any special % time values. You also need to enable Overwrite if file exists.
2. In the Settings Dialog go to Output, set output mode to Advanced and go to the recording tab. Here you set type to "Custom Output (ffmpeg)" and set container format to "hls". Set the file path to a folder.

# config-path: Configuration file path
# [steaming-folder]: The path of the live video directory, which can be configured in the configuration file
# [uploader-name]: Filename under uploader directory (without extension)
yarn start [steaming-folder] -c <config-path> [-u uploader-name]

Play live stream

Use the web player public/player.html to play

Related

• sxzz/free-hls.js HLS upload tool (Written in Node.js)
• sxyazi/free-hls A free HLS video solution

Reference

• How to do HLS streaming in OBS (Open Broadcast Studio)