LAL is an audio/video live streaming broadcast server written in Go. It's sort of like nginx-rtmp-module
, but easier to use and with more features, e.g RTMP, RTSP(RTP/RTCP), HLS, HTTP[S]/WebSocket[s]-FLV/TS, GB28181, H264/H265/AAC/G711/OPUS, relay, cluster, record, HTTP API/Notify/WebUI, GOP cache.
There are 3 ways of installing lal:
First, make sure that Go version >= 1.18
For Linux/macOS user:
$git clone https://github.com/q191201771/lal.git
$cd lal
$make build
Then all binaries go into the ./bin/
directory. That's it.
For an experienced gopher(and Windows user), the only thing you should be concern is that the main function
is under the ./app/lalserver
directory. So you can also:
$git clone https://github.com/q191201771/lal.git
$cd lal/app/lalserver
$go build
Or using whatever IDEs you'd like.
So far, the only direct and indirect dependency of lal is naza(A basic Go utility library) which is also written by myself. This leads to less dependency or version manager issues.
Prebuilt binaries for Linux, macOS(Darwin), Windows are available in the lal github releases page. Naturally, using the latest release binary is the recommended way. The naming format is lal_<version>_<platform>.zip
, e.g. lal_v0.20.0_linux.zip
LAL could also be built from the source wherever the Go compiler toolchain can run, e.g. for other architectures including arm32 and mipsle which have been tested by the community.
option 1, using prebuilt image at docker hub, so just run:
$docker run -it -p 1935:1935 -p 8080:8080 -p 4433:4433 -p 5544:5544 -p 8083:8083 -p 8084:8084 -p 30000-30100:30000-30100/udp q191201771/lal /lal/bin/lalserver -c /lal/conf/lalserver.conf.json
option 2, build from local source with Dockerfile, and run:
$git clone https://github.com/q191201771/lal.git
$cd lal
$docker build -t lal .
$docker run -it -p 1935:1935 -p 8080:8080 -p 4433:4433 -p 5544:5544 -p 8083:8083 -p 8084:8084 -p 30000-30100:30000-30100/udp lal /lal/bin/lalserver -c /lal/conf/lalserver.conf.json
option 3, Use docker-compose
Create a docker-compose.yml
file with the following content:
version: "3.9"
services:
lalserver:
image: q191201771/lal
container_name: lalserver
ports:
- "1935:1935"
- "8080:8080"
- "4433:4433"
- "5544:5544"
- "8083:8083"
- "8084:8084"
- "30000-30100:30000-30100/udp"
command: /lal/bin/lalserver -c /lal/conf/lalserver.conf.json
Run the following command to start the service:
docker-compose up
Or run it in the background with:
docker-compose up -d
Running lalserver:
$./bin/lalserver -c ./conf/lalserver.conf.json
Using whatever clients you are familiar with to interact with lalserver.
For instance, publish rtmp stream to lalserver via ffmpeg:
$ffmpeg -re -i demo.flv -c:a copy -c:v copy -f flv rtmp:https://127.0.0.1:1935/live/test110
Play multi protocol stream from lalserver via ffplay:
$ffplay rtmp:https://127.0.0.1/live/test110
$ffplay rtsp:https://127.0.0.1:5544/live/test110
$ffplay https://127.0.0.1:8080/live/test110.flv
$ffplay https://127.0.0.1:8080/hls/test110/playlist.m3u8
$ffplay https://127.0.0.1:8080/hls/test110/record.m3u8
$ffplay https://127.0.0.1:8080/hls/test110.m3u8
$ffplay https://127.0.0.1:8080/live/test110.ts
Besides a live stream broadcast server which named lalserver
precisely, project lal
even provides many other applications, e.g. push/pull/remux stream clients, bench tools, examples. Each subdirectory under the ./app/demo
directory represents a tiny demo.
Our goals are not only a production server but also a simple package with a well-defined, user-facing API, so that users can build their own applications on it.
LAL
stands for Live And Live
if you may wonder.
Bugs, questions, suggestions, anything related or not, feel free to contact me with lal github issues.
MIT, see License.
this note updated by yoko, 202404