Provides a visualisation of TV and radio stream viewing patterns
JavaScript CSS HTML Ruby Makefile Perl
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
config
doc
lib
public
spec
views
.bowerrc
.gitignore
.jshintrc
AUTHORS
COPYING
Gemfile
Gemfile.lock
Procfile
README.md
Rakefile
bower.json

README.md

VistaTV live dashboard

The VistaTV live dashboard application provides a visualisation of TV and radio stream viewing patterns.

Prerequisites

Getting started

Obtain the code

$ git clone git@github.com:bbc/vistatv_live_dashboard.git
$ cd vistatv_live_dashboard

Install gem dependencies

$ bundle install

Configure

$ cp config/config.yml.example config/config.yml

Edit config/config.yml to your local requirements.

Station logos are found using the logo_template config option. The {{service_id}} placeholder will be replaced with the service id of the station.

If the logo can't be loaded, it will be replaced with the image located at the path in the logo_missing config item.

The initial services to be displayed on the dashboard is determined by the initial_services config item. This should be a list of service ids.

You should also set the faye_endpoint url to use the correct hostname and port of the live dashboard web server.

Data sources

This application subscribes to realtime data from a stats server over a TCP socket connection. It also uses HTTP to request historical data. The data formats are defined in API and Protocol documentation found in doc/protocol.md.

By default, the Ruby application creates a TCP and HTTP connection as defined in config.yml.

JavaScript dependencies

The front end uses d3.js, jQuery and Rickshaw. These components are committed into this repository. However, if you wanted to use Bower to upgrade them, you should install:

Then, run:

$ bower install

License

See COPYING

Authors

See AUTHORS

Copyright

Copyright 2013-2017 British Broadcasting Corporation