Simple server that exposes a directory for video streaming via HTTP Live Streaming (HLS). Uses ffmpeg for transcoding.
This project is cobbled together from all kinds of code I had lying around so it's pretty crappy all around. It also has some serious shortcomings.
Important: You need the ffmpeg and ffprobe binaries in your PATH. The server will not start without them. You can find builds most operating systems at https://ffmpeg.org/download.html.
You can find the latest release on the releases page https://github.com/shimberger/gohls/releases or just download a current snapshot:
The configuration is stored in JSON format. Just call the file gohls-config.json or whatever you like. The format is as follows:
{
"folders": [
{
"path": "~/Videos",
"title": "My Videos"
},
{
"path": "~/Downloads",
"title": "My Downloads"
}
]
}
This will configure which directories on your system will be made available for streaming. See the screenshot for details:
Execute the command gohls serve -config <path-to-config> e.g. gohls serve -config gohls-config.json to serve the videos specified by the config file. To make the server listen on another port or address just use the serve command with --listen like so (the example uses port 7000 on all interfaces): gohls serve --listen :7000 -config <path-to-config>
Visit the URL http://127.0.0.1:8080 to access the web interface.
- go installed
- npm installed (NPM is part of Node.js)
- bash
- Clone the repository
[email protected]:shimberger/gohls.git - Build frontend
cd ui/ && npm install && npm run build && cd ..
To then run the development server execute: ./scripts/run.sh serve
See LICENSE.txt