dduers/icecast-stream-proxy

secure and lockdown your icecast server

1.0.1 2020-05-24 22:58 UTC

This package is auto-updated.

Last update: 2024-12-25 09:33:51 UTC


README

About

This helps you to secure and lock down your icecast streams and stats. You can configure the proxy to support only access from your radio station frontend website.

Abilities

  • relay a icecast stream and its stats meta data
  • supports http basic auth, if your icecast server is configured for it
  • can stream ogg and falls back to mp3 for microsoft browsers
  • restrict stream and stats access for your radio station frontend website only

Limitations

  • ogg and mp3 icecast mount should serve the same content
  • if http basic auth is used, same credentials must be used for all icecast streams

Setup & Configuration

Server

  • composer require dduers/icecast-stream-proxy
  • configuration is documented in examples/example.php

Client

  • you can embed the proxied stream to your website with this html5 code snipped
<audio preload="none">
    <source src="https://www.example.org/streamproxy">
</audio>

Recommendations

  • serve the icecast server, the icecast proxy and your radio station's website over https://
  • (!) the http basic auth credentials are at risk when no secure https connection is uses

Ressources