https://github.com/jonathanstowe/audio-icecast

Interact with the icecast streaming server admin interface.
https://github.com/jonathanstowe/audio-icecast

audio raku stream utility

Last synced: 10 days ago
JSON representation

Interact with the icecast streaming server admin interface.

• Host: GitHub
• URL: https://github.com/jonathanstowe/audio-icecast
• Owner: jonathanstowe
• License: artistic-2.0
• Created: 2016-03-23T12:05:28.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-07T08:43:50.000Z (over 2 years ago)
• Last Synced: 2023-04-22T17:06:59.517Z (over 1 year ago)
• Topics: audio, raku, stream, utility
• Language: Raku
• Homepage:
• Size: 35.2 KB
• Stars: 1
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# Audio::Icecast

Administrative helpers for an icecast server

![Build Status](https://github.com/jonathanstowe/Audio-Icecast/workflows/CI/badge.svg)

## Synopsis

```raku

use Audio::Icecast;

# Using the default configuration

my $icecast = Audio::Icecast.new;

for $icecast.stats.source -> $source {

    say "listeners for { $source.mount }";

    for $icecast.listeners($source) -> $listener {

        say "\t",$listener.ip;

    }

}

```

## Description

This provides a simple interface to the admin interface of an icecast

server.  You can get the statistics, information about the mount points

and do most of the things that you can do through the web UI.

The API itself is quite thin as the icecast server doesn't do much more

than stream audio from a source quite efficiently.

Some features such as static mounts and alternative authentication

mechanisms can only be enabled via the configuration file and

not dynamically, if you want more control over the streams at

runtime then you might consider using a streaming middleware such as

[liquidsoap](http://liquidsoap.fm/) in conjunction with your icecast

server.

You probably should at least familiarise yourself with the [icecast

documentation](http://www.icecast.org/docs/icecast-2.4.1/) before making

serious use of this module.

## Installation

You can install this module using ```zef``` :

    zef install Audio::Icecast

Or if you have the source code locally:

    zef install .

## Support

This isn't very complicated but the interactions with the server are

quite difficult to test without introducing a bunch more dependencies.

You'll have to take my word for it that I tested against a local

icecast server with actual sources and clients :)

Anyhow if you have any suggestions or feedback feel free to post them

at (github)[https://github.com/jonathanstowe/Audio-Icecast/issues] or even better

send a pull request.

## Licence and copyright

This is free software, please see the [LICENCE](LICENCE) file in the distribution.

© Jonathan Stowe 2016 - 2021