Accounts Aanmaken

Software versie: Icecast 2.3.1 

Icecast accounts worden aangemaakt door het configuratiebestand aan te passen met een tekstverwerkingsprogramma. Waarschijnlijk werk je met een config bestand op een server, zodat het nodig zal zijn om een tekstverwerker in de terminal te gebruiken. Probeer nano, pico, of emacs, vi, vim. Als je geen ervaring hebt met tekstverwerkers in de terminal, raad ik je de eerste twee aan.

Als je 1 wachtwoord wilt voor alle encorders (De standaard Icecast instelling) moet je naar het volgende gedeelte kijken:

<source-password>hackme</source-password>

 

In dit geval kan iedereen een stream maken, op ieder mountpoint van je server, met dit wachtwoord ('hackme'). Als je het wachtwoord wilt veranderen, hoef je alleen de tekst tussen de twee tags te veranderen in een nieuwe wachtwoord tekst.

 
Je kan echter ook verschillende mountpoints maken voor  verschillende gebruikers, zodat ze met hun eigen wachtwoord moeten inloggen. Voor deze 'accounts' moet je aangeven wat het mountpoint is dat ze moeten gebruiken. De mogelijkheden om de parameters van deze mountpoints aan te passen zijn nogal uitgebreid, en je kunt het aantal luisteraars, de bitrate, waar de stream op wordt geslagen en zelfs een intro-file (een bestand dat wordt gespeeld voordat de luisteraar de stream hoort) instellen.

Bij dit type wordt ieder account getoond tussen de <mount></mount> tags. Als je een eenvoudig account wilt aanmaken, waar je iemand een gebruikersnaam en wachtwoord geeft om te kunnen streamen, is de configuratie die je toevoegt er zo uitzien:

 <mount> <mount-name>newuser.mp3</mount-name> <password>hackmetoo</password> </mount> 

 
Helaas is het zo dat als je mount 'accounts' zoals hierboven toevoegt aan het configuratiebestand, je Icecast moet dwingen om het configuratiebestand te lezen voordat de veranderingen door worden gevoerd. Je hoeft hier Icecast niet voor te herstarten, maar je moet wel een SIGHUP signaal sturen vanaf de command line. Je doet dit als volgt:

killall -HUP icecast 


Je kunt ook enkele van de volgende parameters toevoegen (de mount-name is altijd nodig): 

  • mount-name
  • username (gebruikersnaam)
  • password (wachtwoord)
  • max-listeners (maximale luisteraars)
  • max-listener-duration (maximale luistertijd)
  • dumpfile (dumpbestand)
  • intro (intro bestand) 
  • fallback mount
  • fallback-override
  • fallback-when-full
  • public
  • stream-name (streamnaam)
  • stream-description (stream beschrijving)
  • stream-url (stream url)
  • genre
  • bitrate
  • type
  • subtype
  • hidden (verborgen)
  • burst-size
  • mp3-metadata-interval
  • authentication-type
  • on-connect
  • on-disconnect

Standaard Account Instellingen

Als we account instellingen zeggen, zijn dat eigenlijk de instellingen voor specifieke mountpoints. De volgende zijn de meest nuttige:

wachtwo0rd

Het wachtwoord dat nodig is voordat een stream geaccepteerd zal worden door de server op dat mountpoint. Het wachtwoord wordt ingevoerd in het wachtwoordveld van de encoder. Als de encoder een commandline encoder is, zal het wachtwoord of in de command line worden toegevoegd, of geplaatste in het config bestand. Als de encoder een GUI (grafische gebruiks interface) heeft, is er vaak een veldje waarin het wachtwoord ingevuld kan worden.

max-listeners (maximaal aantal luisteraars)

Het maximale aantal luisteraars dat een mountpoint tegelijkertijd kan onderstunen. Als je de waarde op 50 zet bijvoorbeeld, kan je tot maximaal 50 gelijktijdige luisteraars hebben. 

dump-file (dump bestand) 

het path en de bestandsnaam waar de stream op dit mountpoint gearchiveerd (opgeslagen) moet worden.

intro

Dit geeft aan dat er een intro gestreamd moet worden op het mountpoitn voordat de luisteraar de stream hoort. Als je bijvoorbeeld een live stream voor een evenement hebt, kan je een korte introductie afspelen als je luisteraar met de stream verbindt, waarna de stream voglt. In dit geval zou je deze optie gebruiken en een link naar het intro bestand invoegen.