adinan-cenci/internet-radio

A library to fetch internet-radio.com radio stations.

v2.1.0 2022-10-15 15:03 UTC

Requires

• php: >=7.0
• guzzlehttp/guzzle: ^7.4

MIT

• Adinan Cenci

• music
• radio

README

An unofficial library to retrieve radio stations from the internet-radio.com catalog.

Stations by genre

Use the ::getStationsByGenre($genre, $offset, $limit, $sortBy) method to retrieve stations labeled with a specific musical genre.

Parameter	Type	Default	Description
$genre	string		The name of a musical genre, see ::getGenres() for possible values.
$offset	int	0
$limit	int	20
$sortBy	string	'featured'	Possible values: featured, listeners, bitrate.

use AdinanCenci\InternetRadio\InternetRadio;

$internetRadio = new InternetRadio();
$stations = $internetRadio->getStationsByGenre('metal');

It will return an array as such:

[
    {
        "id": "idobihowl", 
        "name": "idobi Howl", 
        "description": "metal, hardcore", 
        "homepage": "http://idobiradio.com/", 
        "playlist": "http://69.46.88.26:80/listen.pls", 
        "currentlyPlaying": "SYLOSIS - Fear the World", 
        "listeners": "2527", 
        "bitRate": "128"
    }, 
    {
        "id": "knac.com", 
        "name": "KNAC.COM", 
        "description": "metal", 
        "homepage": "http://www.knac.com", 
        "playlist": "http://198.178.123.14:7346/listen.pls?sid=1", 
        "currentlyPlaying": "NAZARETH - HAIR OF THE DOG", 
        "listeners": "268", 
        "bitRate": "128"
    }, 
    {
        "id": "metalexpressradio", 
        "name": "Metal Express Radio", 
        "description": "heavy metal", 
        "homepage": "http://www.metalexpressradio.com", 
        "playlist": "http://5.135.154.69:11590/listen.pls?sid=1", 
        "currentlyPlaying": "David T. Chastain - Burning Passion", 
        "listeners": "199", 
        "bitRate": "192"
    }
    ...
    ...
    ...

Search stations

Use the ::searchStations($query, $offset, $limit, $sortBy) method to search stations based on their names.

Parameter	Type	Default	Description
$query	string		Word(s) to be matched against station names.
$offset	int	0
$limit	int	20
$sortBy	string	'featured'	Possible values: featured, listeners, bitrate.

Genres

The ::getGenres() returns an array of musical genres used to label radio stations. Use this values to search stations with the ::getStationsByGenre() method.

$genres = $internetRadio->getGenres();
/*
'50s', 
'60s', 
'Acid House', 
'Bass', 
'Jazz', 
'Metal',
...
...
...
*/

Notes

At the moment of this writing, internet-radio.com does not provide an API, the information provided by this library is being scraped from the official website and this library may stop working in the day they decide to update their page.

License

MIT