radiovis-generator 0.1.1

data/README.md

@@ -0,0 +1,109 @@
+## RadioVIS Generator
+
+This is a small gem which allows you to quickly and simply generate slides (comprising of a complex, rendered and composited image, and some text) customised for your station from an SVG source file, a set of substitutions (which can be dynamically driven) and optionally an image to composite behind the SVG output.
+
+The generator also includes a framework for specifying slide durations and intelligently pushing them to your Stomp broker.
+
+It's designed to let any station plug it directly into their infrastructure with a minimal amount of coding and a simple process for non-technical content creators.
+
+### What is RadioVIS?
+
+RadioVIS is a [RadioDNS](http://radiodns.org/) application. It's designed for hybrid radio receivers (Broadcast audio plus IP back channel) but can be used on other platforms such as the internet in addition. A [much better description](http://radiodns.org/about-radiodns/) can be found on the RadioDNS website.
+
+Simply put (though if you want the spec, [it's here](http://radiodns.org/documentation/)) RadioVIS lets receivers and audio player software show an image and a line of text next to your station, and allows for the use of push technologies to update which image and text the receiver is displaying at a given point in time. This allows for content mapped to the output of your station (such as 'Now Playing' information or information on the current show) to be generated and displayed to your users.
+
+## Dependencies
+
+RadioVIS Generator depends on Inkscape (which does not require a GUI) and the ImageMagick project (the 'convert' and 'composite' binaries).
+
+Aside from those two tools, Ruby is required, along with RubyGems. Recent versions are recommended.
+
+You'll also need a Stomp broker, though this can be on another system. You'll probably need a web server like nginx or Apache on your system, though.
+
+RadioVIS Generator is tested on Linux. Other operating systems are supported in principle, but not tested.
+
+## Installation and Usage
+
+Installing is simple. Install the dependencies (on Ubuntu, that's `sudo apt-get install imagemagick inkscape` - add `ruby1.9-full` if you're missing Ruby), and then simply install the gem with `gem install radiovis-generator`. Congratulations, you're good to go!
+
+
+You can test the installation out by using the simple command line program bundled with the generator - see `radiovis-generator --help` for options. This will cycle between the slides provided by the gem, and is intended as a really simple starting point for your own runner.
+
+
+### Simple Usage
+
+RadioVIS Generator comes bundled with a couple of basic templates - one which shows two pieces of information (intended for Now Playing slides), and one which shows just a large title. These will get you off the ground, or at least show you how to customise your slides.
+
+To run RadioVIS Generator is very simple. I'm going to assume you can set up a folder on your system and point your web server at it, and that you've got a Stomp broker running. If this is all correct, then you can run a simple demo by creating a file like this:
+
+```
+require 'rubygems'
+require 'radiovis-generator'
+gen = RadioVISGenerator::Generator.new
+options = {
+  slides: [RadioVISGenerator::BrandingSlide.new, RadioVISGenerator::NowPlayingSlide.new],
+  url: 'http://localhost/radiovis/', # The path on your web server pointing at..
+  path: '/tmp/radiovis-output'       # This path on your filesystem!
+  broadcast_parameters: 'fm/ecc/pi/freq', # See the RadioVIS spec for how to generate this.
+  username: 'system',   # These details are for your Stomp broker.
+  password: 'manager',
+  host: 'localhost',
+  port: 61313
+}
+gen.run(options)
+```
+
+Running this file will perpetually serve up RadioVIS images and text, and send out Stomp messages. You can use a tool like CasterPlay's RadioVIS Monitor to check everything is working. The console output will also tell you more or less what it's doing, or at least let you know if it's obviously not working!
+
+### Customising
+
+Customisation should simply be a matter of making a new subclass of `RadioVISGenerator::Slide`, making a new SVG file and if required a background image, and then adding the new subclass to your runner rotation. So let's say we want a simple slide which is going to have a rotating title and a background image.
+
+```
+class MyCustomSlide < RadioVISGenerator::Slide
+  def generate
+    return {
+      '$$TITLE$$' => ['Some cool text!', 'Some other cool text!'].shuffle.first
+    }
+  end
+  # We don't want this one displayed so often.
+  def redisplay_delay
+    20
+  end
+  # Specify our filename - this is messy because it's relative to the gem.
+  def svg_filename
+    return "/some/path/to/my-custom-slide.svg"
+  end
+  # We want a background image!
+  def background_image
+    return "/some/path/to/my-background.png"
+  end
+end
+```
+
+Now all we need to do is pass `MyCustomSlide.new` to our runner as a slide to consider in the rotation and we're done! We can customise the SVG file or the background image, adjust the text we're dynamically adding in our slide class, or add new dynamic elements through the same mechanism. The only limit is the lengths to which you're willing to figure out how to do things with SVG.
+
+
+Loads more information on how to make your own custom slides can be found in the RDoc documentation or by simply reading the `slide.rb` file.
+
+
+## Credits and Acknowledgements
+
+* This software package was developed by James Harrison, originally as part of the OCD Broadcast Content Management System for [Insanity Radio](http://insanityradio.com).
+* RadioDNS is supported by a [lot of people](http://radiodns.org/supporters/).
+* The [Inkscape](http://inkscape.org/) project provides the kick-ass SVG to PNG converter and a really slick SVG editor.
+* [ImageMagick](http://www.imagemagick.org/script/index.php) has yet to not appear in anything I've ever written. All the contributors rock.
+
+
+## License
+
+Copyright (c) 2012, James Harrison
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of Insanity Radio nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JAMES HARRISON OR INSANITY RADIO BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/bin/radiovis-generator

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'radiovis-generator'
+require 'trollop'
+opts = Trollop::options do
+  opt :url, "Base Image URL", type: String, default: 'http://localhost/radiovis/'
+  opt :path, "Base Image Path", type: String, default: '/tmp/radiovis-output'
+  opt :broadcast_parameters, "Broadcast Parameters", type: String
+  opt :username, "Stomp username", type: String, default: 'system'
+  opt :password, "Stomp password", type: String, default: 'manager'
+  opt :host, "Stomp host", type: String, default: 'localhost'
+  opt :port, "Stomp port", type: :int, default: 61613
+end
+gen = RadioVISGenerator::Generator.new
+options = {
+  slides: [RadioVISGenerator::BrandingSlide.new, RadioVISGenerator::NowPlayingSlide.new]
+}.merge(opts)
+gen.run(options)

data/lib/radiovis-generator.rb

@@ -0,0 +1,116 @@
+require 'stomp'
+
+module RadioVISGenerator
+  class Generator
+    def initialize
+      Generator.has_dependencies?
+    end
+
+    # Runs the generator!
+    # This does all the tying together of things and Stomp interaction.
+    # The generator accepts a hash of options:
+    #   slides - An array of Slide instances.
+    #   url - The root URL at which the pictures can be found from the outside world, ie 'http://blah.com/system/radiovis-images/'.
+    #   path - The root path where we should write the images, ie '/opt/www/website/public/system/radiovis-images'
+    #   broadcast_parameters - The broadcast parameters for your station in RadioVIS topic format, ie 'fm/ECC/PI/FREQUENCY' for FM (like 'fm/ce1/c08f/10320' for Insanity Radio 103.2 FM)
+    #   username - The Stomp username
+    #   password - The Stomp password
+    #   host - The Stomp host
+    #   port - The Stomp port
+    # Sensible defaults are provided for Stomp, but you should set them explicitly.
+    def run(options)
+      defaults = {
+        slides: [],
+        url: 'http://localhost/radiovis/',
+        path: '/tmp/radiovis-output',
+        broadcast_parameters: 'fm/ecc/pi/freq',
+        username: 'system',
+        password: 'manager',
+        host: 'localhost',
+        port: 61313
+      }
+      options = defaults.merge(options)
+      raise ArgumentsError, "No slide instances provided!" unless options[:slides].size > 0
+      puts "Generator starting - parameters #{options.inspect}"
+      begin
+        conn = Stomp::Connection.open options[:username], options[:password], options[:host], options[:port], false
+        while true do
+          # Okay - so here's the plan.
+          # We have a bunch of Slide subclasses which contain what we want.
+          # Every so often we check to see if any need rendering and render whichever has the highest priority.
+          slides_to_render = []
+          options[:slides].each do |slide|
+            slides_to_render.push(slide) if slide.changed?
+          end
+          # If we've got nothing that's changed, pick a redisplay instead.
+          if slides_to_render.size == 0
+            options[:slides].each do |slide|
+              slides_to_render.push(slide) if slide.redisplay?
+            end
+          end
+          # Pick the lowest priority.
+          slides_to_render.sort_by!{|slide|slide.priority}
+          slide = slides_to_render.reverse[0] rescue nil
+          if slide
+            # Go for it!
+            puts "Rendering #{slide.inspect}"
+            puts "Chosen from #{slides_to_render.inspect}"
+            slide_output = slide.render(options[:path])
+
+            # Now we go ahead and send those messages.
+            image_topic = "/topic/#{options[:broadcast_parameters]}/image"
+            text_topic  = "/topic/#{options[:broadcast_parameters]}/text"
+            image_message = "SHOW "+options[:url]+slide_output[:image_small]
+            text_message  = "TEXT "+slide_output[:text]
+            puts "Publishing Stomp messages"
+            puts " - #{image_topic} <= #{image_message}"
+            puts " - #{text_topic} <= #{text_message}"
+            conn.publish(image_topic, image_message, {'persistent'=>'false'})
+            conn.publish(text_topic, text_message, {'persistent'=>'false'})
+            puts "Done, waiting #{slide.display_time} seconds to let people read this slide."
+            # Sleep for this long before we display anything else.
+            sleep slide.display_time
+          else
+            puts "No slide to render, sleeping a second."
+            sleep 1
+          end
+        end
+      #rescue Exception => e
+      #  puts "Got exception #{e}!"
+      #  conn.disconnect rescue nil
+      #  conn = nil
+      #  sleep 5
+      #  retry
+      end
+    end
+
+    def self.has_dependencies?
+      unless self.which('inkscape')
+        raise SystemCallError, "Inkscape is required to use this library.\nYou can install it on Ubuntu/Debian with 'sudo apt-get install inkscape'. (And don't worry, it works headlessly and won't install a full GUI stack).\nSpecifically I need 'inkscape' in my PATH."
+      end
+      unless self.which('convert')
+        raise SystemCallError, "ImageMagick is required to use this library.\nYou can install it on Ubuntu/Debian with 'sudo apt-get install imagemagick'.\nSpecifically I need 'convert' in my PATH."
+      end
+      unless self.which('composite')
+        raise SystemCallError, "ImageMagick is required to use this library.\nYou can install it on Ubuntu/Debian with 'sudo apt-get install imagemagick'.\nSpecifically I need 'composite' in my PATH."
+      end
+    end
+    private
+    # Utility method to identify if a program is available and executable.
+    def self.which(cmd)
+      exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+        exts.each { |ext|
+          exe = "#{path}/#{cmd}#{ext}"
+          return exe if File.executable? exe
+        }
+      end
+      return nil
+    end
+  end
+end
+
+require 'radiovis-generator/slide'
+require 'radiovis-generator/slides/branding_slide'
+require 'radiovis-generator/slides/now_playing_slide'
+

data/lib/radiovis-generator/slide.rb

@@ -0,0 +1,132 @@
+require 'fileutils'
+class RadioVISGenerator::Slide
+  # Generate the substitution hash to process on this run. This is where we add our dynamic content!
+  # Returns a hash where "$$TARGET$$" => "Content", where $$TARGET$$ is the target string to replace in the SVG and Content is the substitute.
+  # This is passed to RadioVISGenerator::Slide.rewrite_svg
+  def generate
+    return {}
+  end
+
+  # Generate the text to display alongside this slide.
+  def text
+    return "Default slide text - RadioVIS Generator"
+  end
+
+  # Has this slide changed since last rendered?
+  # Reset anything you need to in the Slide#generate method.
+  # For instance, if I'm showing the current show or now playing, I'd check if the current track on air
+  #   was the same as the one I'd stored last time I'd rendered. If it were different I'd return true.
+  #   Then in Slide#generate, I'd store the current track on air.
+  # This means we can get very prompt updates on realtime events - maximum delay defined by your largest
+  #   display_time of all the slides, ie 5 seconds with nothing overridden.
+  def changed?
+    return false
+  end
+
+  # What is the priority of this slide? Lower numbers takes precedence. Default 50.
+  def priority
+    return 50
+  end
+
+  # How long should we display this slide for at a minimum? Values under 5 are rarely good.
+  def display_time
+    return 5
+  end
+
+  # How long should we wait between redisplays if we've got nothing better to do (ie no content changed)?
+  def redisplay_delay
+    return 15
+  end
+
+  # What image makes the background of this slide, and should be composited over it?
+  # Return nil to skip the composition stage and just display the SVG output.
+  # Defaults to nil.
+  def background_image
+    return nil
+  end
+
+  # What SVG file are we going to render?
+  # Defaults to an empty slide.
+  def svg_filename
+    return "#{File.expand_path(File.dirname(File.dirname(__FILE__)))}/templates/empty-slide.svg"
+  end
+
+  # Okay, show's over!
+
+  # That's it. Everything up there, define in your subclasses if you want to override them. 
+
+  # Set up the slide. Just sets the last time this slide was rendered up.
+  def initialize
+    @last_render_time = Time.now
+  end
+
+  # Have we gotten bored enough to just show this again, assuming it's not been too little time
+  # (as defined in Slide#redisplay_delay)
+  def redisplay?
+    if @last_render_time < Time.now - 15
+      return true
+    end
+    return false
+  end
+
+
+  # Render this slide, returns a hash with image_big, image_small, output_path, name and text. Paths returned are relative to the provided output_path.
+  # Will create the output path if needed.
+  # Shouldn't be overriden unless you know what you're doing.
+  # Calls Slide#generate and Slide#text to get dynamic content and then spits out some images.
+  def render(output_path)
+    # Reset time-based cycling
+    @last_render_time = Time.now
+    # Make sure our output path exists
+    FileUtils.mkdir_p(output_path) rescue nil
+    Dir.mkdir('/tmp/radiovis-generator') rescue nil # Make our temporary storage
+    RadioVISGenerator::Slide.rewrite_svg(svg_filename, "/tmp/#{self.name}.svg", self.generate)
+    if background_image
+      RadioVISGenerator::Slide.render_svg("/tmp/#{self.name}.svg", "/tmp/#{self.name}-precomp.png")
+      RadioVISGenerator::Slide.composite("/tmp/#{self.name}-precomp.png", background_image, File.join(output_path, "#{self.name}-640x480.png"))
+    else
+      RadioVISGenerator::Slide.render_svg("/tmp/#{self.name}.svg", File.join(output_path, "#{self.name}-640x480.png"))
+    end
+    FileUtils.rm_rf('/tmp/radiovis-generator') rescue nil # Clean up after ourselves
+    # Make our smaller-res version
+    RadioVISGenerator::Slide.resize_to_fit(File.join(output_path, "#{self.name}-640x480.png"), File.join(output_path, "#{self.name}-320x240.png"), '320x240')
+    return {
+      image_big: "#{self.name}-640x480.png",
+      image_small: "#{self.name}-320x240.png",
+      text: self.text,
+      output_path: output_path,
+      name: self.name
+    }
+  end
+
+  # Returns the name of this slide as a friendlyish string to be used in output image names.
+  def name
+    self.class.to_s.downcase.gsub("radiovisgenerator::","")
+  end
+
+  # Rewrites an SVG at a given input path with the information in the given hash to the given output path.
+  # Hash is of the format "$$TARGET$$" => "Content", where $$TARGET$$ is the target string to replace in the SVG and Content is the substitute.
+  def self.rewrite_svg(in_path, out_path, sub_hash)
+    svg_input = File.open(in_path).read()
+    sub_hash.each_pair do |k,v|
+      svg_input = svg_input.gsub(k,v)
+    end
+    File.open(out_path, 'w'){|f|f<<svg_input}
+  end
+
+  # Renders an SVG to a PNG
+  def self.render_svg(in_path, out_path)
+    `inkscape -f #{in_path} -e #{out_path}`
+  end
+
+  # Resize and (if needed) crop to the size of a slide (640x480 by default), using center gravity.
+  def self.resize_to_fit(in_path, out_path, size='640x480')
+    `convert #{in_path} -resize #{size}^ -gravity center -extent #{size} #{out_path}`
+  end
+
+  # Composite two images to another image. Center gravity.
+  def self.composite(top_in_path, bottom_in_path, out_path)
+    `composite -gravity center #{top_in_path} #{bottom_in_path} #{out_path}`
+  end
+
+end

data/lib/radiovis-generator/slides/branding_slide.rb

@@ -0,0 +1,26 @@
+class RadioVISGenerator::BrandingSlide < RadioVISGenerator::Slide
+  # Man, NowPlayingSlide thinks he's got problems. I'm a complete idiot compared to that guy.
+  # Hey, want to help me out? Maybe add some functionality to me?
+  def generate
+    return {
+      '$$STATIONNAME$$' => 'Your Radio Station'
+    }
+  end
+  # I'm just an example slide so I don't actually have a background image bundled.
+  # But here I'd return a full path to whatever I wanted behind my SVG with all the SVG's shiny opacity.
+  def background_image
+    return nil
+  end
+  # We don't want this one displayed so often.
+  def redisplay_delay
+    20
+  end
+  # And it's lower priority. 
+  def priority
+    25
+  end
+  # Specify our filename - this is messy because it's relative to the gem.
+  def svg_filename
+    return "#{File.expand_path(File.dirname(File.dirname(File.dirname(File.dirname(__FILE__)))))}/templates/branding-slide.svg"
+  end
+end

data/lib/radiovis-generator/slides/now_playing_slide.rb

@@ -0,0 +1,14 @@
+class RadioVISGenerator::NowPlayingSlide < RadioVISGenerator::Slide
+  # In here I'd do some clever stuff if I were being clever. But I'm not.
+  # I'm just an example slide. You're clever, right? You can help me out here!
+  def generate
+    return {
+      '$$STATIONNAME$$' => 'Your Radio Station',
+      '$$NOWPLAYING$$'  => 'Some Track is Playing'
+    }
+  end
+  # Specify our filename - this is messy because it's relative to the gem.
+  def svg_filename
+    return "#{File.expand_path(File.dirname(File.dirname(File.dirname(File.dirname(__FILE__)))))}/templates/now-playing-slide.svg"
+  end
+end

data/templates/branding-slide.svg

@@ -0,0 +1,153 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="640"
+   height="480"
+   id="svg4824"
+   version="1.1"
+   inkscape:version="0.48.2 r9819"
+   sodipodi:docname="now-playing-slide.svg">
+  <title
+     id="title4836">RadioVIS Generator Default Slide</title>
+  <defs
+     id="defs4826">
+    <linearGradient
+       id="linearGradient6807">
+      <stop
+         style="stop-color:#333333;stop-opacity:1;"
+         offset="0"
+         id="stop6809" />
+      <stop
+         style="stop-color:#333333;stop-opacity:0.71428573;"
+         offset="1"
+         id="stop6811" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient6807"
+       id="linearGradient6815"
+       x1="19.112589"
+       y1="972.36218"
+       x2="620.88739"
+       y2="972.36218"
+       gradientUnits="userSpaceOnUse"
+       spreadMethod="pad"
+       gradientTransform="matrix(0.2,0,0,5.0000001,908.36218,-5181.8111)" />
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient6807-5"
+       id="linearGradient6815-7"
+       x1="19.112589"
+       y1="972.36218"
+       x2="620.88739"
+       y2="972.36218"
+       gradientUnits="userSpaceOnUse"
+       spreadMethod="pad"
+       gradientTransform="matrix(0.2,0,0,5.0000001,908.36218,-5181.8111)" />
+    <linearGradient
+       id="linearGradient6807-5">
+      <stop
+         style="stop-color:#333333;stop-opacity:1;"
+         offset="0"
+         id="stop6809-7" />
+      <stop
+         style="stop-color:#333333;stop-opacity:0.71428573;"
+         offset="1"
+         id="stop6811-8" />
+    </linearGradient>
+    <linearGradient
+       y2="972.36218"
+       x2="620.88739"
+       y1="972.36218"
+       x1="19.112589"
+       spreadMethod="pad"
+       gradientTransform="matrix(0.13333332,0,0,5.0000001,589.6955,-5181.8111)"
+       gradientUnits="userSpaceOnUse"
+       id="linearGradient6834"
+       xlink:href="#linearGradient6807-5"
+       inkscape:collect="always" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.7"
+     inkscape:cx="197.53061"
+     inkscape:cy="151.88693"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     inkscape:window-width="1122"
+     inkscape:window-height="722"
+     inkscape:window-x="25"
+     inkscape:window-y="25"
+     inkscape:window-maximized="0">
+    <inkscape:grid
+       type="xygrid"
+       id="grid4834"
+       empspacing="5"
+       visible="true"
+       enabled="true"
+       snapvisiblegridlinesonly="true" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata4829">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title>RadioVIS Generator Default Slide</dc:title>
+        <dc:creator>
+          <cc:Agent>
+            <dc:title>James Harrison</dc:title>
+          </cc:Agent>
+        </dc:creator>
+        <dc:rights>
+          <cc:Agent>
+            <dc:title>Creative Commons C0</dc:title>
+          </cc:Agent>
+        </dc:rights>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-572.36218)">
+    <rect
+       style="fill:url(#linearGradient6834);fill-opacity:1;fill-rule:nonzero;stroke:#ffffff;stroke-width:1.44928122;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+       id="rect4838-2"
+       width="80"
+       height="600"
+       x="592.36218"
+       y="-620"
+       transform="matrix(0,1,-1,0,0,0)" />
+    <text
+       xml:space="preserve"
+       style="font-size:40px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#ff8000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="40"
+       y="652.36218"
+       id="text5348-7"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan5350-8"
+         x="40"
+         y="652.36218"
+         style="font-size:48px;fill:#ff8000;fill-opacity:1">$$STATIONNAME$$</tspan></text>
+  </g>
+</svg>

data/templates/empty-slide.svg

@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="640"
+   height="480"
+   id="svg4824"
+   version="1.1"
+   inkscape:version="0.48.2 r9819"
+   sodipodi:docname="New document 23">
+  <title
+     id="title4836">RadioVIS Generator Default Slide</title>
+  <defs
+     id="defs4826" />
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.35"
+     inkscape:cx="-66.428571"
+     inkscape:cy="520"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     inkscape:window-width="1122"
+     inkscape:window-height="722"
+     inkscape:window-x="25"
+     inkscape:window-y="25"
+     inkscape:window-maximized="0">
+    <inkscape:grid
+       type="xygrid"
+       id="grid4834"
+       empspacing="5"
+       visible="true"
+       enabled="true"
+       snapvisiblegridlinesonly="true" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata4829">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title>RadioVIS Generator Default Slide</dc:title>
+        <dc:creator>
+          <cc:Agent>
+            <dc:title>James Harrison</dc:title>
+          </cc:Agent>
+        </dc:creator>
+        <dc:rights>
+          <cc:Agent>
+            <dc:title>Creative Commons C0</dc:title>
+          </cc:Agent>
+        </dc:rights>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-572.36218)" />
+</svg>

data/templates/now-playing-slide.svg

@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="640"
+   height="480"
+   id="svg4824"
+   version="1.1"
+   inkscape:version="0.48.2 r9819"
+   sodipodi:docname="now-playing-slide.svg">
+  <title
+     id="title4836">RadioVIS Generator Default Slide</title>
+  <defs
+     id="defs4826">
+    <linearGradient
+       id="linearGradient6807">
+      <stop
+         style="stop-color:#333333;stop-opacity:1;"
+         offset="0"
+         id="stop6809" />
+      <stop
+         style="stop-color:#333333;stop-opacity:0.71428573;"
+         offset="1"
+         id="stop6811" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient6807"
+       id="linearGradient6815"
+       x1="19.112589"
+       y1="972.36218"
+       x2="620.88739"
+       y2="972.36218"
+       gradientUnits="userSpaceOnUse"
+       spreadMethod="pad"
+       gradientTransform="matrix(0.2,0,0,5.0000001,908.36218,-5181.8111)" />
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient6807-5"
+       id="linearGradient6815-7"
+       x1="19.112589"
+       y1="972.36218"
+       x2="620.88739"
+       y2="972.36218"
+       gradientUnits="userSpaceOnUse"
+       spreadMethod="pad"
+       gradientTransform="matrix(0.2,0,0,5.0000001,908.36218,-5181.8111)" />
+    <linearGradient
+       id="linearGradient6807-5">
+      <stop
+         style="stop-color:#333333;stop-opacity:1;"
+         offset="0"
+         id="stop6809-7" />
+      <stop
+         style="stop-color:#333333;stop-opacity:0.71428573;"
+         offset="1"
+         id="stop6811-8" />
+    </linearGradient>
+    <linearGradient
+       y2="972.36218"
+       x2="620.88739"
+       y1="972.36218"
+       x1="19.112589"
+       spreadMethod="pad"
+       gradientTransform="matrix(0.13333332,0,0,5.0000001,589.6955,-5181.8111)"
+       gradientUnits="userSpaceOnUse"
+       id="linearGradient6834"
+       xlink:href="#linearGradient6807-5"
+       inkscape:collect="always" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.7"
+     inkscape:cx="197.53061"
+     inkscape:cy="151.88693"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     inkscape:window-width="1122"
+     inkscape:window-height="722"
+     inkscape:window-x="25"
+     inkscape:window-y="25"
+     inkscape:window-maximized="0">
+    <inkscape:grid
+       type="xygrid"
+       id="grid4834"
+       empspacing="5"
+       visible="true"
+       enabled="true"
+       snapvisiblegridlinesonly="true" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata4829">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title>RadioVIS Generator Default Slide</dc:title>
+        <dc:creator>
+          <cc:Agent>
+            <dc:title>James Harrison</dc:title>
+          </cc:Agent>
+        </dc:creator>
+        <dc:rights>
+          <cc:Agent>
+            <dc:title>Creative Commons C0</dc:title>
+          </cc:Agent>
+        </dc:rights>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-572.36218)">
+    <rect
+       style="fill:url(#linearGradient6815);fill-opacity:1;fill-rule:nonzero;stroke:#ffffff;stroke-width:1.77499986;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+       id="rect4838"
+       width="120"
+       height="600"
+       x="912.36218"
+       y="-620"
+       transform="matrix(0,1,-1,0,0,0)" />
+    <text
+       xml:space="preserve"
+       style="font-size:40px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Sans"
+       x="40"
+       y="952.36218"
+       id="text5348"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan5350"
+         x="40"
+         y="952.36218"
+         style="font-size:32px;fill:#ffffff">$$NOWPLAYING$$</tspan></text>
+    <rect
+       style="fill:url(#linearGradient6834);fill-opacity:1;fill-rule:nonzero;stroke:#ffffff;stroke-width:1.44928122;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+       id="rect4838-2"
+       width="80"
+       height="600"
+       x="592.36218"
+       y="-620"
+       transform="matrix(0,1,-1,0,0,0)" />
+    <text
+       xml:space="preserve"
+       style="font-size:40px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#ff8000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="40"
+       y="652.36218"
+       id="text5348-7"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan5350-8"
+         x="40"
+         y="652.36218"
+         style="font-size:48px;fill:#ff8000;fill-opacity:1">$$STATIONNAME$$</tspan></text>
+  </g>
+</svg>

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification 
+name: radiovis-generator
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- James Harrison
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-04-09 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: trollop
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: stomp
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: An extendable gem to generate slide images and text for RadioVIS systems and publish them in an intelligent rotation
+email: james@talkunafraid.co.uk
+executables: 
+- radiovis-generator
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/radiovis-generator/slide.rb
+- lib/radiovis-generator/slides/branding_slide.rb
+- lib/radiovis-generator/slides/now_playing_slide.rb
+- lib/radiovis-generator.rb
+- templates/empty-slide.svg
+- templates/now-playing-slide.svg
+- templates/branding-slide.svg
+- README.md
+- bin/radiovis-generator
+has_rdoc: true
+homepage: http://jamesharrison.github.com/radiovis-generator
+licenses: 
+- Modified BSD
+post_install_message: Thanks for installing! Please do visit http://jamesharrison.github.com/radiovis-generator and carefully read the documentation.
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- ImageMagick v6 or better, Inkscape
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A RadioVIS slide generator
+test_files: []
+