Channels - Psy-Virus/ampache GitHub Wiki

Channels

Channels are running server-side and never stop if random or loop parameters are enabled. Based on existing Ampache playlists and Icecast compatible, it's a good way to play the same non-stop music to several third party applications / clients, without any additional server software requirement.

Ampache Configuration

To create an unique stream, transcoding must be setup and the target format transcode-allowed. Then edit config/ampache.cfg.php according to these settings:

channel = true

Create a channel

  • First, create a new playlist with the music you want on it.
  • Then on the playlist details, choose to Create channel and configure according to the parameter list bellow:
  • Name: the displayed channel name on Ampache and third-party applications
  • Description: the channel description
  • URL: public stream url access. You should keep the default value if Apache htaccess is setup correctly at installation process.
  • Interface: the channel will listen on a network interface. It is recommended to listen to the local interface / loopback and to use the public stream url for external access.
  • Port: the channel listening port. Because each channel is running independently, a different port is required for each one. The port should be automatically incremented.
  • Authentication Required: require Ampache authentication on public url
  • Random: play songs in random order
  • Loop: when the associated playlist reach the end, start again from the beginning
  • Max Listeners: maximum allowed listeners on the same time
  • Stream type: the stream format (= transcode output)
  • Bitrate: the stream bitrate

Start a channel

Channels can be started and stopped from the web interface, in Channels page. This could require additional web server permissions to run shell application from php.

You can also start the channel from your terminal using php bin/channel_run.inc -c 1 > /dev/null & where 1 is the channel identifier to start.