Livestreamer in a Docker container
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Run livestreamer inside a Docker container. Exposes a HTTP stream pointing to original content in port 8080.


Simple usage

docker run --rm --net=host blackxored/livestreamer best

Explicit port mapping

Container exposes streaming server at port 8080.

docker run --rm -p 8080:8080 blackxored/livestreamer

Advanced usage with config

For logging in and setting extra configuration options, you may mount a file as a directory inside the container.

docker run --rm -p 8080:8080 -v ~/.livestreamerrc:/root/.livestreamerrc blackxored/livestreamer best

You can easily leverage this by creating a shell alias:

alias livestreamer="docker run -rm -p 8080:8080 -v ~/.livestreamerrc:/root/.livestreamerrc blackxored/livestreamer"

And then use it like:

livestreamer best

Connecting the video player

Depending on your OS, you need to point your player to either localhost, or the IP of your Docker Linux VM. Ex:


For license information on the software included in this image, see Livestreamer LICENSE.


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request