Skip to content

gbrousse/IcecastAuth

Repository files navigation

IcecastAuth Build Status Coverage Status

Total Downloads Latest Stable Version

PHP library used to authenticate listeners via Icecast authentication (URL) (http://icecast.org/docs/icecast-2.4.1/auth.html). This library execute your own functions or methods on Icesast server events.

Installation

Install the latest version with

$ composer require gbrousse/icecast-auth

Basic usage

Create a PHP File that the Icecast server can reach

<?php

use IcecastAuth\IcecastAuth; 
$IceAuth = new IcecastAuth();

// Setup
$IceAuth->setAuthCallback('function1'); // REQUIRED : Set the function call for the authentication 
        
// Execute
$IceAuth->execute();

Setup callback function will receive as argument an array containing :

  • server : domain of the Icecast server
  • port : the port use to call the stream
  • client : an unique id set by Icecast for the listener
  • mountpoint : the mount called by listener
  • ip : ip of the listener
  • all GET parameters in the stream url called by the listener

Configure mount on Icecast server

<mount>
    <mount-name>/example.ogg</mount-name>
    <authentication type="url">
    	<option name="mount_add" value="[URL OF THE SCRIPT YOU CREATE ABOVE]"/>
        <option name="auth_header" value="icecast-auth-user: 1"/>
        <option name="timelimit_header" value="icecast-auth-timelimit:"/>
    </authentication>
</mount>

Examples

About

Requirements

  • IcecastAuth works with PHP 5.3 or above.

Submitting bugs and feature requests

Bugs and feature request are tracked on GitHub

Author

Gregory Brousse - pro@gregory-brousse.fr - http://gregory-brousse.fr

License

IcecastAuth is licensed under the LGPL-3.0 License - see the LICENSE file for details

About

PHP library used to authenticate listeners via Icecast authentication via the URL system (http://icecast.org/docs/icecast-2.4.1/auth.html)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages