Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gwuhaolin/livego
live video streaming server in golang
https://github.com/gwuhaolin/livego
flash flv golang h264 hls livestream rtmp video
Last synced: 20 days ago
JSON representation
live video streaming server in golang
- Host: GitHub
- URL: https://github.com/gwuhaolin/livego
- Owner: gwuhaolin
- License: mit
- Created: 2017-05-28T08:11:36.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T08:42:06.000Z (7 months ago)
- Last Synced: 2024-09-30T18:01:28.716Z (about 1 month ago)
- Topics: flash, flv, golang, h264, hls, livestream, rtmp, video
- Language: Go
- Homepage:
- Size: 2.49 MB
- Stars: 9,685
- Watchers: 231
- Forks: 2,002
- Open Issues: 138
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - gwuhaolin/livego
- my-awesome - gwuhaolin/livego - 04 star:9.7k fork:2.0k live video streaming server in golang (Go)
- awesome - gwuhaolin/livego - live video streaming server in golang (Go)
- awesome-repositories - gwuhaolin/livego - live video streaming server in golang (Go)
- awesome-github-star - livego
- awesome-starts - gwuhaolin/livego - live video streaming server in golang (Go)
- go-awesome - livego - live server (Open source library / Video)
- awesome-hacking-lists - gwuhaolin/livego - live video streaming server in golang (Go)
README
[中文](./README_cn.md)
[](https://github.com/gwuhaolin/livego/actions?query=workflow%3ATest)
[](https://github.com/gwuhaolin/livego/actions?query=workflow%3ARelease)
Simple and efficient live broadcast server:
- Very simple to install and use;
- Pure Golang, high performance, and cross-platform;
- Supports commonly used transmission protocols, file formats, and encoding formats;
#### Supported transport protocols
- RTMP
- AMF
- HLS
- HTTP-FLV
#### Supported container formats
- FLV
- TS
#### Supported encoding formats
- H264
- AAC
- MP3
## Installation
After directly downloading the compiled [binary file](https://github.com/gwuhaolin/livego/releases), execute it on the command line.
#### Boot from Docker
Run `docker run -p 1935:1935 -p 7001:7001 -p 7002:7002 -p 8090:8090 -d gwuhaolin/livego` to start
#### Compile from source
1. Download the source code `git clone https://github.com/gwuhaolin/livego.git`
2. Go to the livego directory and execute `go build` or `make build`
## Use
1. Start the service: execute the livego binary file or `make run` to start the livego service;
2. Get a channelkey(used for push the video stream) from `http://localhost:8090/control/get?room=movie` and copy data like your channelkey.
3. Upstream push: Push the video stream to `rtmp://localhost:1935/{appname}/{channelkey}` through the` RTMP` protocol(default appname is `live`), for example, use `ffmpeg -re -i demo.flv -c copy -f flv rtmp://localhost:1935/{appname}/{channelkey}` push([download demo flv](https://s3plus.meituan.net/v1/mss_7e425c4d9dcb4bb4918bbfa2779e6de1/mpack/default/demo.flv));
4. Downstream playback: The following three playback protocols are supported, and the playback address is as follows:
- `RTMP`:`rtmp://localhost:1935/{appname}/movie`
- `FLV`:`http://127.0.0.1:7001/{appname}/movie.flv`
- `HLS`:`http://127.0.0.1:7002/{appname}/movie.m3u8`
5. Use hls via https: generate ssl certificate(server.key, server.crt files), place them in directory with executable file, change "use_hls_https" option in livego.yaml to true (false by default)
all options:
```bash
./livego -h
Usage of ./livego:
--api_addr string HTTP manage interface server listen address (default ":8090")
--config_file string configure filename (default "livego.yaml")
--flv_dir string output flv file at flvDir/APP/KEY_TIME.flv (default "tmp")
--gop_num int gop num (default 1)
--hls_addr string HLS server listen address (default ":7002")
--hls_keep_after_end Maintains the HLS after the stream ends
--httpflv_addr string HTTP-FLV server listen address (default ":7001")
--level string Log level (default "info")
--read_timeout int read time out (default 10)
--rtmp_addr string RTMP server listen address
```
### [Use with flv.js](https://github.com/gwuhaolin/blog/issues/3)
Interested in Golang? Please see [Golang Chinese Learning Materials Summary](http://go.wuhaolin.cn/)