ghostream/README.md

34 lines
1.4 KiB
Markdown
Raw Normal View History

2020-09-23 11:52:12 +00:00
# Ghostream
2020-09-25 13:26:33 +00:00
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
2020-09-23 11:52:12 +00:00
[![pipeline status](https://gitlab.crans.org/nounous/ghostream/badges/master/pipeline.svg)](https://gitlab.crans.org/nounous/ghostream/commits/master)
[![coverage report](https://gitlab.crans.org/nounous/ghostream/badges/master/coverage.svg)](https://gitlab.crans.org/nounous/ghostream/-/commits/master)
2020-09-23 11:52:12 +00:00
*Boooo!* A simple streaming server with authentication and open-source technologies.
2020-09-25 13:26:33 +00:00
This project was developped at [Cr@ns](https://crans.org/) to stream events.
2020-09-23 11:52:12 +00:00
Features:
- WebRTC playback with a lightweight web interface.
- Low-latency streaming, sub-second with web player.
- Authentification of incoming stream using LDAP server.
## Installation with Docker
An example is given in [docs/docker-compose.yml](docs/docker-compose.yml).
2020-09-23 11:52:12 +00:00
It uses Traefik reverse proxy.
2020-09-27 20:13:51 +00:00
You can also launch the Docker image using,
```
2020-09-27 20:14:35 +00:00
docker build . -t ghostream
2020-09-27 20:13:51 +00:00
docker run -it --rm -p 8080:8080 -p 2112:2112 -p 9710:9710 ghostream
```
2020-09-23 11:52:12 +00:00
## References
- Phil Cluff (2019), *[Streaming video on the internet without MPEG.](https://mux.com/blog/streaming-video-on-the-internet-without-mpeg/)*
- MDN web docs, *[Signaling and video calling.](https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API/Signaling_and_video_calling)*
2020-09-24 17:01:26 +00:00
- [WebRTC For The Curious](https://webrtcforthecurious.com/)