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
- Create an SI.xml file 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
- If you want to enable Service Following between broadcast and IP Streaming, you must also provide at least one streaming URL
- Put your SI.xml file on your webserver. This HOWTO guide can help.
- Make sure you have a _radioepg._tcp SRV record pointing to your webserver, using this HOWTO guide.
- 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>
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>
Hosting and Signalling
The SI file should be stored on an HTTP webserver, in the following locations
Please note that the URLs are case sensitive.
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 may 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