Oshyn Home Page
  • expertise
    • Overview
    • Contact Us |
    • Latest work: www.miramax.com
  • solutions
    • Overview
    • Content Management
      • Common Issues
      • Choosing a CMS
      • Training
      • Drupal Development
      • Jahia Integration
      • Sitecore Consulting
      • Open Text Web Solutions RedDot CMS
      • EPiServer CMS Consulting
    • E-commerce
    • SOA
    • Portals & Collaboration
    • Web Strategy
    • Mobile Platforms
    • Social Media
    • Contact Us |
    • Latest work: www.miramax.com
  • work
    • Overview
    • Client Quotes
    • Contact Us |
    • Latest work: www.websense.com
  • resources
    • Overview
    • News & Events
    • Newsletters
    • Blog
    • White Papers
    • Success Stories
    • Press Kit
    • Contact Us |
    • Latest work: www.disneydvd.com
  • partners
    • Overview
    • Agency Partner Program
    • Technology Partners
    • Contact Us |
    • Latest work: www.nea.org
  • company
    • Overview
    • Contact
    • Careers
    • Leadership Team
    • News & Events
    • Social Responsibility
    • Contact Us |
    • Latest work: www.icon4x4.com
Audio and Video Streaming with Liquidsoap and Icecast
  • Tweet
Monday, June 14, 2010  /   Eric Aguayo Eric Aguayo
close

Eric Aguayo


Audio and Video Streaming with Liquidsoap and Icecast

Recent studies indicate that online audio and video streaming and other multimedia resources are becoming more popular than conventional TV and radio by making use of different tools such as Icecast, Shoutcast, Liquidsoap, etc. In the past, conventional TV and radio stations broadcasted their content over the internet as an alternative source for consumers and in some cases as a means to reach people living abroad. Nowadays, for TV and especially for radio stations it is a “must” to be able to stream their content over the internet because that is where many consumers are looking for it. This change in consumer behavior provides more opportunities for smaller companies that provide online audio and video streams to promote their content over the internet and reach a greater audience.

Streaming live convent over the internet requires much more extra care than just providing web page content since a downtime in the service can significantly affect the image of the company and cause it to lose content consumers and advertisers. There are several services on the internet that provide services to reliably stream audio and video content over the internet. However these paid services can be very expensive due to the importance of the availability of the service. Nevertheless, there is a cheaper alternative which is secure and reliable at the same time to set up an audio and/or video stream service on your own.

Any streaming service requires 3 components in order to work: a streaming server, a stream source and a client.

  • Streaming server:  This is the main component that passes (and sometimes re-encode) the audio and/or video content from each of the sources to the connected audience. There are several streaming servers both proprietary and open source that can be used. Among the open source alternatives, the most popular are Shoutcast and Icecast, both are easy to install and have proved to be very reliable and secure. To provide a single streaming point Shoutcast is the preferred option, however, to provide a more flexible service that allows multiple sources (different bitrates for example) Icecast might be more suitable. The advantage of Icecast over Shoutcast is that it introduces the concept of mountpoints which are independent streams mounted over the same server which distributes the resources efficiently among all the mountpoints. A Shoutcast example will be shown in this case.
  • Stream Source: A source provides the audio and/or video content to the streaming server. It usually provides capabilities to manage playlists and re-encode audio/video content. It does not need to be on the same physical server as the streaming server but it is recommended to be on a different server. A plugin for Winamp can be used as a source for a Shoutcast server which basically will send any content played on Winamp to a Shoutcast stream server. Liquidsoap is very powerful and programmable streaming source that allows generating a reliable streaming with fallback options. Liquidsoap can be used with either Icecast or Shoutcast. In addition, Liquidsoap provides a very strong a powerful API that allows generating different playlists, introducing jingles and defining fallback sources to produce a continuous streaming in case the main source becomes unavailable. Fallback is also available at server level in Icecast to provide an even more reliable streaming. The liquidsoap API also provides DSP (Digital Signal Processing) capabilities that allow programmatically mixing tracks, normalizing and controlling volume, and even introducing some effects. In this example, A simple Liquisoap script will be shown
  • Client: A client is referred to the software being used by the consumer to playback the stream.  This can vary greatly and depends on the preference of each user, but most of the current players (WMP, Quicktime, Winamp, iTunes, etc) will be able to playback audio streams in mp3 and other widely used formats. Some players provide plug-ins so streams can be played directly from the web browser. Other common formats in audio streams are aac+, asf, and ogg.

The following are the steps to set-up a streaming server in an Ubuntu server. First we need to install the Icecast streaming server, so we execute the following code as root

apt-get install icecast2

Then we need to edit the Icecast configuration file which can be done with your favorite editor, in this case to open with VIM execute

vim /etc/icecast2/icecast2.xml

In the XML file you will find several options that can be configured depending on the resources available on your system and network. More details about these settings can be found on the Icecast website.

Change the following lines to set up the credentials you want to use for authentication, the source password will generally be used for all the clients connecting to the server unless specified on the mountpoint; the default username for sources is “source”

<authentication>
  
<!-- Sources log in with username 'source' -->
       <source-password>hackmesource</source-password>
       <!-- Admin logs in with the username given below -->
       <admin-user>admin</admin-user>
       <admin-password>hackmeadmin</admin-password>
</authentication>

Change the following lines to indicate the port you want to use to access the stream server, in this case I have changed the default which is 8000 to 80 so I do not need to specify the port when accessing through the web browser (i.e. ‘http://localhost’ can be used instead of ‘http://localhost:8000’).

<listen-socket>
   <port>80</port>
</listen-socket>

Finally define one or more mountpoints to be used to access the streamed content. You can set up a fallback mountpoint in case a source is not available. Here is an example of a mountpoint, username and password that will override the default source username and password defined.

<mount>
    <mount-name>/radio</mount-name>
    <username>radio</username>
    <password>hackmeradio</password>
    <burst-size>65536</burst-size>
    <fallback-mount>/backuprelay</fallback-mount>
    <fallback-override>1</fallback-override>
    <fallback-when-full>1</fallback-when-full>
    <bitrate>128</bitrate>
    <genre>Electronica</genre>
</mount>

Save the configuration file and restart the server with the following line as root

service icecast2 restart

Now we need to install the source, in this case we are going to use liquidsoap. You can easily install liquidsoap by executing the following line

apt-get install liquidsoap

However if you want to get full support for mp3 streaming, it is recommended to build liquidsoap from the source by downloading liquidsoap-full-xxx.tar.gz file from the sourceforge download site. Instructions on how to install from the source are very straightforward and can be found on the project website.

After installing liquidsoap, we need to tell it what to play, so we need to write a script that makes use of the Liquidsoap API. Liquidsoap will automatically read any file with extension .liq on the folder /etc/liquidsoap, so we are going to create the following example script named radio.liq within this folder

#!/usr/bin/liquidsoap
# Set the files and playlists,
default = single("/root/default.mp3")
jingles = playlist("/root/jingles")
tech =  playlist.safe("/root/featured/tech")
minimal = playlist("/root/featured/minimal")
prog_trance = playlist("/root/featured/prog trance")
tech_trance = playlist("/root/featured/tech trance")
electro_house = playlist("/root/featured/electro house")
prog_house = playlist("/root/featured/prog house")
psy = playlist("/root/featured/psy")
chillout = playlist("/root/featured/chillout")
sets = playlist("/root/featured/sets")
liveset = mksafe(input.http("http://66.7.216.22:8968"))
liveset = rewrite_metadata([("artist", "Santiago Saa"),("title", "120 minutest Live")], liveset)
# Play files and playlists according to the radio program,
# and the default file if anything goes wrong.
radio = fallback(
  [ switch( track_sensitive=false,
    [
      ({ (1w or 2w or 3w) and 5h-8h }, prog_house),
      ({ (4w or 5w) and 5h05-8h }, prog_house),
      ({ (1w or 2w or 3w or 4w or 5w) and 8h-11h }, prog_trance),
      ({ (1w or 2w or 3w or 4w or 5w) and 11h-13h }, electro_house),
      ({ (1w or 2w or 3w or 4w or 5w) and 13h-15h }, prog_house),
      ({ (1w or 2w or 3w or 4w or 5w) and 15h-17h }, tech),
      ({ (1w or 2w or 3w or 4w or 5w) and 17h-20h }, sets),
      ({ (1w or 2w or 3w or 4w or 5w) and 20h-22h }, tech),
      ({ (1w or 2w or 3w or 4w or 5w) and 22h-0h }, prog_house),
      ({ 2w and 0h-5h }, psy),
      ({ 3w and 0h-5h }, psy),
      ({ 4w and 0h-3h }, psy),
      ({ 4w and 3h-5h05 }, liveset),
      ({ 5w and 0h-3h }, psy),
      ({ 5w and 3h-5h05 }, liveset),
      ({ 6w and 0h-3h }, psy),
      ({ 6w and 3h-5h05 }, liveset),
      ({ 6w and 5h05-8h }, psy),
      ({ 6w and 8h-11h }, tech_trance),
      ({ 6w and 11h-18h }, prog_trance),
      ({ 6w and 18h-21h }, tech_trance),
      ({ 6w and 21h-0h }, psy),
      ({ 7w and 0h-2h }, tech_trance),
      ({ 7w and 2h-3h }, psy),
      ({ 7w and 3h-5h }, psy),
      ({ 7w and 5h-7h }, tech),
      ({ 7w and 7h-23h59 }, minimal),
      ({ 1w and 0h-5h }, minimal),
      ({ true }, tech),
    ]),
  tech])
# Add the normal jingles
radio = random(weights=[1,5],[ jingles, radio ])
# Output the full stream in OGG and MP3
output.icecast.mp3(
  host="localhost",port=80, user”radio”,password="hackmeradio",
  genre="Electronica",url="http://localhost",
  description="Radio",mount="radio",
  name="(((( Evolution Bass Radio ))))", bitrate=128,radio)

Finally we need to restart liquidsoap so the script can be parsed and loaded

service liquidsoap restart

The scripting language is very straightforward, single and playlist commands are used to create sources. The Playlist command in this case will read all the files on the indicated folder, however if a specific file is specified it will read the audio files listed on that file. The liveset variable takes external sources to pass it to the stream which can be used to broadcast live streams. Next we use the fallback and switch commands to program the radio to play the different playlists according to a specific calendar and play a default playlist in case anything goes wrong, in this case we are using tech as the default playlist. By using the playlist.safe command we ensure that playlist will be loaded before the service starts, making it a reliable source. Making stream sources safe can consume several resources during startup but will ensure the reliability of the stream. We include jingles played randomly by using the random command. Finally we output the whole radio source to the Icecast server in mp3 format by using the command output.Icecast.mp3. Note that we are indicating the username and password previously set up on the Icecast configuration file.

The script shows some of the capabilities of liquidsoap, however the script can be as complex as needed. It is recommendable to plan how the service is going to work and what will be the fallback points in case any of the sources become unavailable before they start writing the script. A full API reference and more sample scripts can be found on the liquidsoap project site.

  • Share
  • Facebook    0
  • Twitter    0
Trackback Link
http://www.oshyn.com/BlogRetrieve.aspx?BlogID=1906&PostID=148619&A=Trackback
Trackbacks
Post has no trackbacks.

blog comments powered by Disqus

Pages: Previous Next

TwitterFacebookLinkedIn

Blog Authors

Christian Burne Christian Burne
question button image

 



Captcha Image

question button image
Subscribe Subscribe Subscribe Subscribe Subscribe
OTHER CATEGORIES
  • ALL

  • General

  • Web Content Management

  • Sitecore CMS

  • Open Text

  • Jahia

  • Drupal

  • EpiServer

  • SOA

  • Social Media and Mobile

  • Software Development

  • Visit Bloggers Profiles

RELATED POSTS
  • The Software Development Process: Scrum Projects
  • The Software Development Process: Building a House or Building a Car for Mars?
  • Jahia 6.5 vs Liferay 6.0 Part 2: Extensibility
  • Improving Mobile User Experience with HTML5
  • Jahia 6.5 vs Liferay 6.0 Part 1: Content Integration
  • JavaScript Navigation using Hash Change "#"
  • Jahia 6.5 Integration of Jahia Actions and DataTables
  • Websites on Smartphones, iPad & Tablets - Gesture Events for Mobile Devices
  • Websites on Smartphones, iPad & Tablets – Using Touch Events for Image Scrolling on your site
  • CSS3 Best Practices

WHITE PAPERS
    ajax rotator

    Web Content Management, Social Media, Content: Three Kings for Your Website Web Content Management, Social Media, Content: Three Kings for Your Website (846 KB)
    Companies pursuing online marketing success, including Social Media, can increase the power of their online presence with right strategy and technology to maximize online visibility and engagement. Download this FREE white paper on the WCM, Social Media, and Content triad.

    Drupal Performance Tuning Drupal Performance Tuning (1213 KB)
    In this Free White Paper Oshyn evaluates Drupal Performance Tuning, sharing the results of testing response time and Requests Per Second (RPS) that a server can hold before the response rate becomes unacceptable. In this paper you will learn about optimizing performance of a website through changes to settings and the server.

    Enterprise Drupal: Social Media, Mobile, and Rich Media in your Website Enterprise Drupal: Social Media, Mobile, and Rich Media in your Website (1015 KB)
    In this free WCM white paper, Oshyn examines advanced Drupal capabilities: Multisite Environment, Access Control and Security, Enhanced User Profiles, Custom Breadcrumbs, Mobile Support, Podcasts, Advanced Multimedia, Locations and Maps, Internationalization and Locale based content, Events and Scheduled Tasks, Rules Actions and E-Commerce Solutions.

    Drupal Multilingual Drupal Multilingual (636 KB)
    There are several multilingual installation methods for Drupal. In this free white paper Oshyn evaluates and recommends several methods of using Drupal Open Source CMS to manage websites in multiple languages.

    Drupal Social Media Drupal Social Media (1297 KB)
    Looking for an Open Source CMS to for “Social Media Optimization” of your website? Download this free white paper, “Drupal and Social Media”, to learn about the extensive Social Media this Open Source CMS offers to create a dynamic and engaging website and online community.

    Drupal Multisite Options Drupal Multisite Options (427 KB)
    There are several multisite installation methods for Drupal. In this free white paper Oshyn evaluates and recommends several methods of using Drupal Open Source CMS to manage multiple sites.

    Open Source CMS: Is It Right for your Organization Open Source CMS: Is It Right for your Organization (496 KB)
    In this free white paper, “Open Source CMS: Is It Right for your Organization?” we share an in-depth look at the pros and cons of using Open Source Content Management Systems (CMS) or Open Source Web Content Management (WCM) platforms. Oshyn helps clients select CMS/WCM solutions based on the specific requirements of each client.

    Affiliate Content Sharing in a CMS/WCM World Affiliate Content Sharing in a CMS/WCM World (273 KB)
    The Content Editors at your company have created GREAT content! Now how do you share it? In this Free white paper learn several methods for using a Content Syndication tool to automatically repurpose content and how Content Sharing can generate business value.

    Sitecore and Social Media - An Interactive Web Content Management Platform Sitecore and Social Media - An Interactive Web Content Management Platform (898 KB)
    Social Media has revolutionized how people interact with business. In this white paper Oshyn’s Lead Sitecore Developer, Prasanth Nittala, discusses key points from the perspectives of marketing and Web development that make Sitecore a compelling choice for engaging in Social Media via your website. This Sitecore white paper draws from Oshyn’s expertise as a certified Sitecore partner, helping organizations understand the distinct capabilities offered by Sitecore CMS.

    The Business Case for Leveraging Open Text Web Solutions Delivery Manager The Business Case for Leveraging Open Text Web Solutions Delivery Manager (451 KB)
    This free white paper explores the evolving needs of small and medium size businesses and explains how the Open Text Web Solutions Delivery Manager (formerly RedDot LiveServer) can help businesses build their brand, reputation, and client base. This white paper examines strategies, key points and tips to leverage the features available in Open Text Web Solutions (RedDot CMS) to achieve an impactful user experience and to maximize visitor engagement through a reliable and powerful implementation.

    Open Text Best Practices: Part One Open Text Best Practices: Part One (763 KB)
    Authored by Oshyn Senior Consultant, Adaeze Okorie, this free CMS white paper draws from Oshyn’s vast experience as an Open Text Certified Partner, in helping organizations define strategies to meet business goals while implementing Open Text Web Solutions (RedDot CMS). Specifically in this free white paper Adaeze Okorie discusses strategies, key points and tips to leverage the features available in Open Text Web Solutions (RedDot CMS) to achieve an effective, reliable and robust implementation.

    Improving the ROI of Business Software: Service Oriented Architecture from a Business Perspective Improving the ROI of Business Software: Service Oriented Architecture from a Business Perspective (398 KB)
    Software selection and technology decision making should no longer be left to the IT department alone. By gaining an understanding of Service-Oriented Architecture, business people outside of the IT department will be better positioned to maximize the ROI of the company's technology platforms. Download this free white paper to learn more.

    Getting Over Social Media Marketing Paralysis for B2B Getting Over Social Media Marketing Paralysis for B2B (2254 KB)
    Many companies are well aware that Social Media has become critically important to engaging audiences and promoting online "presence" while some wonder how to approach their C-level executives and prove that it is not all hype. With so many ways to engage in Social Media, how can they get buy-in and begin execution with so many different venues and tools available? Staying on the sidelines and becoming a latecomer might make it more difficult to create a convincing "social" presence. Put the ove

    Performance Tuning Open Text Web Solutions Management Server and Delivery Server Performance Tuning Open Text Web Solutions Management Server and Delivery Server (235 KB)
    If you've made an investment in Open Text Web Solutions (formerly RedDot) Web Content Management products, you’ve undoubtedly experienced performance issues. While every CMS requires tuning, Open Text Web Solutions - RedDot is especially susceptible to mis-configuration and poor performance as the out-of-the-box installation comes untuned and ready for Development Environments only. In this FREE white paper we share performance tuning expertise as an Open Text Certified Partner that has optimize

    The Business Case for Leveraging Open Text Web Solutions Within Higher Education The Business Case for Leveraging Open Text Web Solutions Within Higher Education (430 KB)
    Academic institutions have a long reputation for being slower to adopt new technologies for their audiences. However, many schools are taking serious steps in improving the online experience they are providing. This white paper explores the unique needs of the higher education market, applying new tools & trends and specifically how the Open Text Web Solutions’ Delivery Manager (formerly known as RedDot LiveServer) can be leveraged to achieve those goals.

    SEO Best Practices within a Content Management System SEO Best Practices within a Content Management System (712 KB)
    In this free white paper, we share Search Engine Optimization (SEO) tips and best practices to follow when implementing a Content Management System (CMS). Certain features and functionality will help your content editors make website changes faster while minimizing the risk of human error. Download this free white paper to learn strategies to improve search engine rankings.

    Best Practices for Sitecore CMS Best Practices for Sitecore CMS (1121 KB)
    Sitecore CMS is an extensive Web Content Management (WCM) platform for the mid-market. It offers reduced IT expenditures, a streamlined content lifecycle, and a return of content control to the subject matter experts. The newest incarnation of Sitecore CMS version 6.0 is a mature product that incorporates standard social media components such as wikis, blogs, RSS syndication and “e-mail a friend” features.

    Optimizing SEO in your CMS (WCM) Optimizing SEO in your CMS (WCM) (3108 KB)
    Oshyn's Christian Burne spoke in depth about SEO in CMS at the Gilbane San Francisco Conference on June 3rd, 2009. Christian discussed the pressues of keyword competition and how the CMS can add tremendous power to climbing Google SERPs and other search engine rankings. The presentation was later part of a featured article on CMSWire. We've made the presentation available in PDF format. Download now to learn more about strategies for using your CMS to optimize SEO.

    The Best CMS for You: Tips on How to Select Your Next CMS The Best CMS for You: Tips on How to Select Your Next CMS (909 KB)
    As websites continue to grow in size, features and functionality, the visitors to these websites are also becoming more demanding and have higher expectations than ever before. Companies who committed valuable time and resources to web strategies just five years ago are finding they must re-evaluate and explore new options as their content, features and online offerings must keep pace with the constant and rapid movement in the digital marketplace. For many of these companies, there is a strong.

    Oshyn Sample Voluntary Product Accessibility Template (VPAT) Oshyn Sample Voluntary Product Accessibility Template (VPAT) (741 KB)
    Section 508 requires that when federal government and agencies procure, develop, and maintain or use electronic and information technology (EIT), they must ensure that it is accessible and in compliance with Section 508 standards developed by the Architectural and Transportation Barriers Compliance Board (Access Board). Oshyn understands these requirements and has delivered reports like these countless times.

    Sitecore CMS Implementation Best Practices Sitecore CMS Implementation Best Practices (481 KB)

    TwitterFacebookLinkedInAlltopFeatured in Alltop
    Oshyn, Inc.17785 Center Court Drive N Cerritos, CA 90703    1.888.483.1770 newbusiness@oshyn.com
    2012 Copyright Oshyn. All rights reserved.
    • View Mobile Version
    • Terms of Use
    • Privacy Policy
    • Contact Us