Automatically kick and ban “bad” listeners from your Shoutcast server

I decided a few minutes ago that I’d like to make AudioProbe a bit less appetizing to stream rippers. Here’s the result:

First, create shoutcast-config.php
This file holds all of the configuration details for your shoutcast servers. I keep this in a separate file since I include this in other applications on the site. You can add as many servers as you want.

//server can add as many servers as you want in following format...just simply copy and paste this code block to add a new server (update the info of course)
$serv["host"][] = ""; # host address  # port IP address
$serv["port"][] = 80; # port number
$serv["passwd"][] = "pass"; # admin password

Create ban.php:

//import our list of server(s)
//our banned useragents...feel free to add as many as you'd like
$banneduas=array("WinampMPEG/5.0", "WinampMPEG/5.50");
//if you would like to ban the IP in addition to kicking it, set this to TRUE
//Do NOT touch below this line
     * xml2array() will convert the given XML text to an array in the XML structure. 
     * Link: 
     * Arguments : $contents - The XML text 
     *                $get_attributes - 1 or 0. If this is 1 the function will get the attributes as well as the tag values - this results in a different array structure in the return value.
     *                $priority - Can be 'tag' or 'attribute'. This will change the way the resulting array sturcture. For 'tag', the tags are given more importance.
     * Return: The parsed XML in an array form. Use print_r() to see the resulting array structure. 
     * Examples: $array =  xml2array(file_get_contents('feed.xml')); 
     *              $array =  xml2array(file_get_contents('feed.xml', 1, 'attribute')); 
    function xml2array($contents, $get_attributes=1, $priority = 'tag') { 
        if(!$contents) return array(); 
        if(!function_exists('xml_parser_create')) { 
            //print "'xml_parser_create()' function not found!"; 
            return array(); 
        //Get the XML parser of PHP - PHP must have this module for the parser to work 
        $parser = xml_parser_create(''); 
        xml_parser_set_option($parser, XML_OPTION_TARGET_ENCODING, "UTF-8"); # 
        xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0); 
        xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1); 
        xml_parse_into_struct($parser, trim($contents), $xml_values); 
        if(!$xml_values) return;//Hmm... 
        $xml_array = array(); 
        $parents = array(); 
        $opened_tags = array(); 
        $arr = array(); 
        $current = &$xml_array; //Refference 
        //Go through the tags. 
        $repeated_tag_index = array();//Multiple tags with same name will be turned into an array 
        foreach($xml_values as $data) { 
            unset($attributes,$value);//Remove existing values, or there will be trouble 
            //This command will extract these variables into the foreach scope 
            // tag(string), type(string), level(int), attributes(array). 
            extract($data);//We could use the array by itself, but this cooler. 
            $result = array(); 
            $attributes_data = array(); 
            if(isset($value)) { 
                if($priority == 'tag') $result = $value; 
                else $result['value'] = $value; //Put the value in a assoc array if we are in the 'Attribute' mode 
            //Set the attributes too. 
            if(isset($attributes) and $get_attributes) { 
                foreach($attributes as $attr => $val) { 
                    if($priority == 'tag') $attributes_data[$attr] = $val; 
                    else $result['attr'][$attr] = $val; //Set all the attributes in a array called 'attr' 
            //See tag status and do the needed. 
            if($type == "open") {//The starting of the tag '<tag>' 
                $parent[$level-1] = &$current; 
                if(!is_array($current) or (!in_array($tag, array_keys($current)))) { //Insert New tag 
                    $current[$tag] = $result; 
                    if($attributes_data) $current[$tag. '_attr'] = $attributes_data; 
                    $repeated_tag_index[$tag.'_'.$level] = 1; 
                    $current = &$current[$tag]; 
                } else { //There was another element with the same tag name 
                    if(isset($current[$tag][0])) {//If there is a 0th element it is already an array 
                        $current[$tag][$repeated_tag_index[$tag.'_'.$level]] = $result; 
                    } else {//This section will make the value an array if multiple tags with the same name appear together
                        $current[$tag] = array($current[$tag],$result);//This will combine the existing item and the new item together to make an array
                        $repeated_tag_index[$tag.'_'.$level] = 2; 
                        if(isset($current[$tag.'_attr'])) { //The attribute of the last(0th) tag must be moved as well 
                            $current[$tag]['0_attr'] = $current[$tag.'_attr']; 
                    $last_item_index = $repeated_tag_index[$tag.'_'.$level]-1; 
                    $current = &$current[$tag][$last_item_index]; 
            } elseif($type == "complete") { //Tags that ends in 1 line '<tag />' 
                //See if the key is already taken. 
                if(!isset($current[$tag])) { //New Key 
                    $current[$tag] = $result; 
                    $repeated_tag_index[$tag.'_'.$level] = 1; 
                    if($priority == 'tag' and $attributes_data) $current[$tag. '_attr'] = $attributes_data; 
                } else { //If taken, put all things inside a list(array) 
                    if(isset($current[$tag][0]) and is_array($current[$tag])) {//If it is already an array... 
                        // ...push the new element into that array. 
                        $current[$tag][$repeated_tag_index[$tag.'_'.$level]] = $result; 
                        if($priority == 'tag' and $get_attributes and $attributes_data) { 
                            $current[$tag][$repeated_tag_index[$tag.'_'.$level] . '_attr'] = $attributes_data; 
                    } else { //If it is not an array... 
                        $current[$tag] = array($current[$tag],$result); //...Make it an array using using the existing value and the new value
                        $repeated_tag_index[$tag.'_'.$level] = 1; 
                        if($priority == 'tag' and $get_attributes) { 
                            if(isset($current[$tag.'_attr'])) { //The attribute of the last(0th) tag must be moved as well
                                $current[$tag]['0_attr'] = $current[$tag.'_attr']; 
                            if($attributes_data) { 
                                $current[$tag][$repeated_tag_index[$tag.'_'.$level] . '_attr'] = $attributes_data; 
                        $repeated_tag_index[$tag.'_'.$level]++; //0 and 1 index is already taken 
            } elseif($type == 'close') { //End of tag '</tag>' 
                $current = &$parent[$level-1]; 
//retrieve xml stats from each server
for ($count = 0; $count < count($serv["host"]); $count++) {
    $mysession = curl_init();
    curl_setopt($mysession, CURLOPT_URL, "http://".$serv["host"][$count].":".$serv["port"][$count]."/admin.cgi?mode=viewxml");
    curl_setopt($mysession, CURLOPT_HEADER, false);
    curl_setopt($mysession, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($mysession, CURLOPT_POST, false);
    curl_setopt($mysession, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
    curl_setopt($mysession, CURLOPT_USERPWD, "admin:".$serv["passwd"][$count]);
    curl_setopt($mysession, CURLOPT_FOLLOWLOCATION, true);
    curl_setopt($mysession, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv: Gecko/20070725 Firefox/");
    curl_setopt($mysession, CURLOPT_CONNECTTIMEOUT, 2);
    $xml = curl_exec($mysession);
    if(is_array($result[SHOUTCASTSERVER][LISTENERS][LISTENER])) {
        foreach($result[SHOUTCASTSERVER][LISTENERS][LISTENER] as $l) {
            if(in_array($l[USERAGENT], $banneduas, FALSE)) {
                if($ban) {
                    //must ban first since user will stay connected unless he is susequently kicked
                    curl_setopt($mysession, CURLOPT_URL, "http://".$serv["host"][$count].":".$serv["port"][$count]."/admin.cgi?mode=bandst&bandst=".$l[POINTER]."&banmsk=255");
                //kick the user
                curl_setopt($mysession, CURLOPT_URL, "http://".$serv["host"][$count].":".$serv["port"][$count]."/admin.cgi?mode=kickdst&kickdst=".$l[POINTER]);

You can set this to run periodically by using a Cron job. Your host should be able to assist you with setting it up. For example, on a cPanel server, the command would be this:

/usr/bin/curl -s http://YOURDOMAIN/ban.php >/dev/null 2>&1

Enjoy and please let me know if you find it useful! 🙂

  • djhohoho

    could you please add some function to count how many users have been banned, thank you.

    • audioprobe

      The best way to obtain this information is to look in SHOUTcast’s .ban file or in the SHOUTcast admin interface. Another choice is to add a few lines to the script to either write to a log file or write to a database.

  • Guest I

    Thanks for this excellent script 🙂