tuner

Project Logo

Open meta-data for the next generation of broadcast radio user interfaces

Technical Details

Project Logo establishes a minimum meta-data set, defined in XML files, which describes your radio station.

This page explains how to implement Project Logo for your station, and the minimum meta-data that you must provide.

4 Steps to Project Logo for your station

  1. Create SI.xml and XSI.xml files for your stations. You can do it yourself or use our tool and this HOWTO guide
    • Each station must have Short Name, Medium Name, Short Description, Long Description, 5 different sized logos
  2. Put your SI.xml and XSI.xml files on your webserver. This HOWTO guide can help.
  3. Make sure you have a _radioepg._tcp SRV record pointing to your webserver, using this HOWTO guide.
  4. Register your stations with RadioDNS, using this HOWTO guide.

That’s all there is. But keep reading if you want to know more detail.

Note: If your radio station is on FM, it must be transmitting RDS information to use RadioDNS.

The Project Logo Meta-Data Elements & Attributes

The following elements and attributes will always be present in Project Logo meta-data. The exact definition of these elements and attributes is given in the Service and Programme Information specification v3.1.1. Broadcasters can optionally include additional elements and attributes.

<serviceInformation xmlns creationTime xsi:lang>
     <services>
          <service>
               <shortName>
                        <mediumName>
                        <genre>
			<mediaDescription>
				<shortDescription>
                                <longDescription>
				<multimedia url type height width>
                                (5 instances - 32px x 32px, 32px x 112px, 128px x 128px, 320px x 240px, 600px x 600px)
			<bearer id cost mimeType bitrate offset>
			<radiodns fqdn, serviceIdentifier>

Example XML

Here is an example of a <service> definition for an FM radio station on 96.9MHz using PI code c691 in the UK (ce1):

<?xml version="1.0" encoding="UTF-8"?>
<serviceInformation xmlns="http://www.worlddab.org/schemas/spi/31"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:xml="http://www.w3.org/XML/1998/namespace"
        xsi:schemaLocation="http://www.worlddab.org/schemas/spi/31 spi_31.xsd"
        creationTime="2016-03-29T10:15:15Z" originator="The Service Provider" xml:lang="en">
    <services>
        <service>
            <shortName>all fm</shortName>
            <mediumName>all fm</mediumName>
            <longName>all fm</longName>
            <mediaDescription>
                <shortDescription>The real voice of Manchester</shortDescription>
            </mediaDescription>
            <mediaDescription>
                <longDescription>All fm is a community radio station broadcasting to South, Central and East Manchester.
All fm’s purpose is to provide the communities of south, East and Central Manchester with the chance to work and train in a media environment, in order to improve their skills for life, education, training and work. As well as providing a medium of expression, especially for those whose voice may not ordinarily be heard.
All fm is a volunteer led organisation. Over one hundred volunteers present, produce and help run the station. We broadcast for over 16 hours per day, 7 days per week, focussing on music, talk and community issues.
We provide shows for specific communities such as South Asian, African, Afro Caribbean, Polish and Irish communities, disabled people and young people.</longDescription>
            </mediaDescription>
            <mediaDescription>
                <multimedia url="http://us.cdn.radioplayer.org.s3.amazonaws.com/radiodns/logos/1210_32x32.png" type="logo_colour_square" />
            </mediaDescription>
            <mediaDescription>
                <multimedia url="http://us.cdn.radioplayer.org.s3.amazonaws.com/radiodns/logos/1210_112x32.png" type="logo_colour_rectangle" />
            </mediaDescription>
            <mediaDescription>
                <multimedia url="http://us.cdn.radioplayer.org.s3.amazonaws.com/radiodns/logos/1210_128x128.png" type="logo_unrestricted" width="128" height="128" mimeValue="image/png" />
            </mediaDescription>
            <mediaDescription>
                <multimedia url="http://us.cdn.radioplayer.org.s3.amazonaws.com/radiodns/logos/1210_320x240.png" type="logo_unrestricted" width="320" height="240" mimeValue="image/png" />
            </mediaDescription>
            <mediaDescription>
                <multimedia url="http://us.cdn.radioplayer.org.s3.amazonaws.com/radiodns/logos/1210_600x600.png" type="logo_unrestricted" width="600" height="600" mimeValue="image/png" />
            </mediaDescription>
            <genre href="urn:radioplayer:metadata:cs:Category:2012:5"></genre>
            <keywords>levenshulme,longsight, all fm, south manchester</keywords>
            <bearer id="fm:ce1.c691.09690" cost="0" />
        </service>
    </services>
</serviceInformation>

Differences between SPI (v3.1.1) and RadioEPG (v1.1)

The current version of the Service and Programme Information specification is v3.1.1, and all new implementations must use this version, which produces an SI.xml file. However broadcasters should consider providing the same information in the prior version of RadioEPG v1.1, for legacy receivers (known as an XSI.xml file).

To help this, there is an XSL-T transformation, which will produce a v1.1 compliant XSI file from a v3.1.1 compliant SI file. This XSI file should be served from the same host as the SI file, but on the path /radiodns/epg/XSI.xml

Hosting and Signalling

The SI (and XSI) files should be stored on an HTTP webserver, in the following locations

{host}/radiodns/spi/3.1/SI.xml
{host}/radiodns/epg/XSI.xml

Please note that the URLs are case sensitive.

Go back to the Project Logo Hub Page