samvera_hls 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 248a3ec8d2a9e81ce645daa12c8d3a8f71056f52
+  data.tar.gz: 25a3e187c1359fbe35c6ac746d8cf38f5b2e9b88
+SHA512:
+  metadata.gz: c927805c5399255af71c80a29336654b63b25c8fec9011b18d1ed5126cd6e3c1cef31621759483560f0f17a09707392854eb9f3377c8e63a4d710874a88bba77
+  data.tar.gz: 81b8213a48f8c9e6bd25360de8dec1dad4909b15b4fd68ddee74dbb67fdefb700982171c505d2f79a88bbaddd92c8b4341549da4bb1ec3413ae2b0416fa33de0

data/LICENSE

@@ -0,0 +1,16 @@
+##########################################################################
+#
+# Copyright 2016 University of California Santa Cruz Library Digital Initiatives Department
+# Additional copyright may be held by others, as reflected in the commit log
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

data/README.md

@@ -0,0 +1,63 @@
+
+## Synopsis
+
+This gem allows a samvera application to create hls derivative media files automatically after uploading audiovisual media files, and to display those to a user through hls adaptive streaming.
+
+## Motivation
+
+Samvera is a promising digital asset management solution with a growing feature set, and we wanted to use as a streaming media service for audiovisual collections. One Samvera based application - [Avalon Media System](https://github.com/avalonmediasystem) - is designed specifically to support multimedia streaming. However, when this module was developed, Avalon was not as feature rich or as fully developed as [Sufia](https://github.com/samvera/sufia) (another Samvera "head") as an asset management system, and its developer community is relatively small. Avalon also relies on a clunky third party transcoding service (Matterhorn) and external streaming server (Red5 or Wowza), creating an unweildly and bug-prone software stack. We wanted the streaming power and flexiblity promised by Avalon, in a more flexible and feature-rich asset management system like Sufia. This gem aims to integrate all of the benefits of adaptive bitrate streaming into Sufia's existing simple, efficient system for creating multimedia derivative files. 
+
+## Security & tokens
+
+This software is not a DRM solution. We do not claim or intend to offer protection against authorized clients storing streamed media and then using it in undesired ways. We only seek to limit streaming from our servers to authorized clients.
+
+Streaming media presents a challenge in balancing speed with security. Media streaming requires many requests to a server, each for a small segment of the media file being played. Each of these requests must be individually authenticated to prevent access by unauthorized users. We want to give our Rails app full control over which users are authorized to view which files - but if we load our whole Rails app for each media request, we put a big load on the server and ruin our streaming media performance. On the other hand, if we don't authenticate requests for media segments (Avalon doesn't) we risk people creating their own playlist files linking directly to those segments and bypassing our authorization system entirely.
+
+Instead, my Rails engine uses signed tokens (using a SHA-256 hash and secret key) which grant direct access to a specific file's media segments for a specified period of time. When an authorized client requests a media segment, the token is authenticated by a lightweight external script which does not need to load the entire Rails app. If a malicious client tries to link to this segment file, the link will break quickly when the token expires.
+
+## Requirements
+
+An apache server is required. This may or may not be the same server that serves your Rails app (through passenger).
+
+## Installation
+
+###Install the gem
+Add the following to your gem file:
+
+```gem 'samvera_hls'```
+
+then run the following from your rails app root directory:
+
+```
+bundle install
+rails generate samvera_hls:install
+```
+
+### Update apache config
+These instructions assume you have an apache server running.
+Edit the appropriate configuration file for your apache server. For my setup on CentOS 7 using passenger, I added this code to the file `/etc/httpd/conf.d/10-sufia.conf` inside the VirtualHost directive .
+Add the following lines, inserting a random secret key of your own and inserting the absolute path to your rails app.
+```
+ SetEnv hls_token_secret "PUT_A_SECRET_KEY_HERE"
+ RewriteEngine on
+ RewriteMap hls_auth "prg:/RAILS_PATH/bin/hls_auth"
+ RewriteRule ^/stream/.*\.ts$ "${hls_auth:%{REQUEST_URI}}"
+```
+then restart your server
+```sudo systemctl restart httpd```
+
+### Create link to derivative folder
+It is probably possible to create this link automatically, but I have not set that up yet. You need to create this symbolic link manually. The rewrite rule you created in the last step keeps this path from being accessible publicly. Note that the apache directive FollowSymLinks must be set for this to work properly.
+```
+sudo su - samverauser
+ln -s /mnt/MY/DERIVATIVE/PATH /srv/MY/WEB/APP/public/stream
+logout
+```
+
+## Usage
+
+When you ingest new audio or visual files, hls derivatives ought to be created automatically along with the other derivative files. View partials are included for displaying these. And "Embed" action is created for file sets, allowing an endpoint for embedding these in other websites using iframes.
+
+## License
+
+[www.apache.org/licenses/LICENSE-2.0](Apache License, v2.0)

data/Rakefile

@@ -0,0 +1,35 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+#require 'rdoc/task'
+
+#RDoc::Task.new(:rdoc) do |rdoc|
+#  rdoc.rdoc_dir = 'rdoc'
+#  rdoc.title    = 'HydraHls'
+#  rdoc.options << '--line-numbers'
+#  rdoc.rdoc_files.include('README.rdoc')
+#  rdoc.rdoc_files.include('lib/**/*.rb')
+#end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+Dir[File.join(File.dirname(__FILE__), 'tasks/**/*.rake')].each {|f| load f }
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+task :default => :spec
+
+load 'rails/tasks/statistics.rake'
+
+Bundler::GemHelper.install_tasks
+

data/app/assets/javascripts/browser_notification.js

@@ -0,0 +1,39 @@
+function isChrome(nAgt) {
+  return nAgt.indexOf('Chrome') != -1
+}
+
+function getMacVersion(nAgt) {
+  var macreg = /Mac OS X/;
+  if (macreg.test(nAgt)) {
+    //it is a mac
+    return /Mac OS X (10[\.\_\d]+)/.exec(nAgt)[1].replace(/_/g,".");
+  }
+  return false;  
+}
+
+function versionCompare(left, right) {
+    if (typeof left + typeof right != 'stringstring')
+        return false;    
+    var a = left.split('.')
+    ,   b = right.split('.')
+    ,   i = 0, len = Math.max(a.length, b.length);
+        
+    for (; i < len; i++) {
+        if ((a[i] && !b[i] && parseInt(a[i]) > 0) || (parseInt(a[i]) > parseInt(b[i]))) {
+            return true;
+        } else if ((b[i] && !a[i] && parseInt(b[i]) > 0) || (parseInt(a[i]) < parseInt(b[i]))) {
+            return false;
+        }
+    }
+    
+    return 0;
+}
+
+$(document).ready(function(){
+  var nAgt = navigator.userAgent;
+  if (isChrome(nAgt)) {
+    if(versionCompare("10.12",getMacVersion(nAgt)))
+      alert('Warning: our streaming media sometimes has problems displaying on your operating system when using the Chrome browser. If you experience problems viewing content, try using another browser such as Safari or Firefox, or update your operating system to the latest version of OS X.');
+  }
+});
+

data/app/assets/javascripts/embed.js

@@ -0,0 +1,18 @@
+// This is a manifest file that'll be compiled into embed.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require browser_notification
+//= require jquery
+//= require mediaelement-and-player
+//= require mep-feature-playlist
+//= require hls_initialize
+

data/app/assets/javascripts/hls_initialize.js.erb

@@ -0,0 +1,22 @@
+$(document).ready(function(){
+
+    if(typeof isPlaylist == "undefined")
+        isPlaylist = false;
+    if(isPlaylist) {
+        $(".hls-media").mediaelementplayer({
+            audioWidth: '100%',
+            loop: true,
+            shuffle: false  ,
+            playlist: true,
+            playlistposition: 'bottom',
+            features: ['playlistfeature', 'prevtrack', 'playpause', 'nexttrack', 'loop', 'shuffle', 'playlist', 'current', 'progress', 'duration', 'volume'],
+            flashName: "<%= asset_path("flashmediaelement.swf")  %>"
+        });
+    } else {
+        $(".hls-media").mediaelementplayer({
+	    audioWidth: '100%',
+            flashName: "<%= asset_path("flashmediaelement.swf")  %>"
+        });
+    }
+ });
+

data/app/assets/javascripts/include_player.js

@@ -0,0 +1,17 @@
+// This is a manifest file that'll be compiled into include_player.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require browser_notification
+//= require mediaelement-and-player
+//= require mep-feature-playlist
+//= require hls_initialize
+

data/app/assets/stylesheets/embed.css

@@ -0,0 +1,16 @@
+/*
+ * This is a manifest file that'll be compiled into embed.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any styles
+ * defined in the other CSS/SCSS files in this directory. It is generally better to create a new
+ * file per style scope.
+ *
+ *= require mediaelementplayer.min
+ *= require mep-feature-playlist
+ *= require samvera-hls-styles
+ */

data/app/assets/stylesheets/hydra-hls-styles.scss

@@ -0,0 +1,20 @@
+.mejs-container.hls-media.mejs-audio {
+   height:auto !important;
+}
+
+.mejs-container.hls-media {
+    clear:both;
+    min-height: 30px;
+
+    .mejs-layers { padding-top:2em; }
+
+    .mejs-playlist.mejs-layer  {
+        position: relative !important;
+        ul.mejs { margin-top:0px !important;}
+    }
+    
+    .mejs-controls {
+        bottom:auto;
+        top:0;
+    }
+}

data/app/assets/stylesheets/samvera-hls-styles.scss

@@ -0,0 +1,20 @@
+.mejs-container.hls-media.mejs-audio {
+   height:auto !important;
+}
+
+.mejs-container.hls-media {
+    clear:both;
+    min-height: 30px;
+
+    .mejs-layers { padding-top:2em; }
+
+    .mejs-playlist.mejs-layer  {
+        position: relative !important;
+        ul.mejs { margin-top:0px !important;}
+    }
+    
+    .mejs-controls {
+        bottom:auto;
+        top:0;
+    }
+}

data/app/controllers/concerns/samvera_hls/file_sets_controller_behavior.rb

@@ -0,0 +1,43 @@
+module SamveraHls
+  module FileSetsControllerBehavior
+    extend ActiveSupport::Concern
+
+#    skip_authorize_resource :only => [:show,:embed,:master,:variant]
+
+    def embed
+      response.headers["X-FRAME-OPTIONS"] = "ALLOWALL"
+      fs = FileSet.find(params[:id])
+      @playlist_url = fs.hls_master_url
+      @media_partial = media_display_partial(fs)
+      render layout: false
+    end
+    
+    def master
+      fs = FileSet.find(params[:id])
+      render inline: fs.hls_master_playlist(root_url), content_type: 'application/x-mpegurl'
+    end
+
+    def variant
+      fs = FileSet.find(params[:id])
+      render inline: fs.hls_segment_playlist(root_url,params[:format]), content_type: 'application/x-mpegurl'
+    end
+
+    def media_display_partial(file_set)
+      'curation_concerns/file_sets/media_display/' +
+        if file_set.image?
+          'image'
+        elsif file_set.video?
+          'video_hls'
+        elsif file_set.audio?
+          'audio_hls'
+        elsif file_set.pdf?
+          'pdf'
+        elsif file_set.office_document?
+          'office_document'
+        else
+          'default'
+        end
+    end
+
+  end
+end

data/app/models/concerns/samvera_hls/file_set_behavior.rb

@@ -0,0 +1,149 @@
+require "samvera_hls/derivatives/video_derivatives"
+require "samvera_hls/derivatives/audio_derivatives"
+
+module SamveraHls
+  module FileSetBehavior
+    extend ActiveSupport::Concern
+
+    def create_derivatives(filename)
+      case mime_type
+      when *self.class.audio_mime_types
+        hls_dir = File.join(derivative_dir,"hls")
+        create_audio_derivates filename, hls_dir
+      when *self.class.video_mime_types
+        hls_dir = File.join(derivative_dir,"hls")
+        create_video_derivates filename, hls_dir
+      else
+        super
+      end
+    end
+
+    def hls_master_url
+        File.join("file_set",id,"hls.m3u8")
+    end
+
+    def hls_master_playlist root_url
+        type = mime_type.split('/')[0]
+        defaults = hls_config[type]["default"]
+        playlist = "#EXTM3U\n"
+        playlist << "#EXT-X-VERSION:6\n"
+        variants.each{|variant| 
+          next if variant.blank?
+          path, filename = File.split(variant)
+          format = filename.gsub(".m3u8","")
+          options = defaults.merge(hls_config[type][format])
+          playlist << "#EXT-X-STREAM-INF:PROGRAM-ID=1,"
+          playlist << "BANDWIDTH=#{options["maxrate"]},"
+          playlist << "CODECS=\"#{options["codec_code"]}\","
+          playlist << "RESOLUTION=#{options["resolution"]}\n"
+          playlist << File.join(root_url,variant_url(format)) + "\n"
+        }
+        playlist
+    end
+
+    def hls_segment_playlist root_url, format
+      playlist = ""
+      File.open(segment_playlist_path(format),'r') {|file|
+        file.each_line do |line|
+          if line.include? ".ts" then
+            playlist << File.join(root_url,
+                                  segment_url_base,
+                                  timestamp.to_s,
+                                  token(line),
+                                  line).strip+"\n"
+          else
+            playlist << line.strip+"\n"
+          end
+        end
+      }
+      playlist
+    end
+
+
+    module ClassMethods
+
+      def audio_mime_types
+        # audio/x-wave is the mime type that fits 0.6.0 returns for a wav file.
+        # audio/mpeg is the mime type that fits 0.6.0 returns for an mp3 file.
+        ['audio/mp3', 'audio/mpeg', 'audio/wav', 'audio/x-wave', 'audio/x-wav', 'audio/ogg', 'audio/flac','audio/x-flac', 'audio/x-aiff', 'audio/aiff', ]
+      end
+    end
+
+
+
+    private
+
+    def segment_url_base
+      File.join("stream",derivative_url,"hls")
+    end
+
+    def variants
+      variants = Dir.glob(File.join(derivative_dir,"hls","*.m3u8"))
+      variants.map!{ |file| 
+        name = File.split(file)[1]
+      }
+    end
+
+    def variant_url format 
+        File.join("file_set",id,format,"variant.m3u8")
+    end
+
+    def create_audio_derivates filename, hls_dir
+      outputs = [
+        { label: 'mp3', format: 'mp3', url: derivative_url('mp3') },
+        { label: 'ogg', format: 'ogg', url: derivative_url('ogg') },
+        { label: 'hls_hd', format: 'hls_hd',path: hls_dir}, 
+        { label: 'hls', format: 'hls', path: hls_dir}]
+      SamveraHls::Derivatives::AudioDerivatives.create(filename,{:outputs => outputs})
+    end
+
+    def create_video_derivates filename, hls_dir
+      outputs = [{ label: :thumbnail, format: 'jpg', url: derivative_url('thumbnail') },
+                 { label: 'webm', format: 'webm', url: derivative_url('webm') },
+                 { label: 'mp4', format: 'mp4', url: derivative_url('mp4') },
+                 { label: 'hls_high', format: "hls_high", path: hls_dir}, 
+                 { label: 'hls_med', format: "hls_med", path: hls_dir}, 
+                 { label: 'hls_low', format: "hls_low", path: hls_dir}]
+      SamveraHls::Derivatives::VideoDerivatives.create(filename,{:outputs => outputs})
+    end
+
+    def token line
+      @token ||=  Digest::SHA256.hexdigest("/" + File.join(segment_url_base,timestamp.to_s,line).strip[0...-9] + token_secret)
+    end
+
+    def timestamp
+      @timestamp ||= Time.now.to_i + 7200
+    end
+
+    def token_secret
+      @token_secret ||= ENV['hls_token_secret']
+    end
+
+    def hls_config
+      @hls_config ||= YAML.load_file(Rails.root.join('config','hls.yml'))
+    end
+
+    def segment_playlist_path format
+        File.join(derivative_dir,"hls",format+".m3u8")
+    end
+
+    def derivative_url(destination_name = nil)
+      if destination_name.nil?
+        @deriv_url ||= derivative_dir.gsub(CurationConcerns.config.derivatives_path,"")
+      else
+        path = derivative_path(destination_name)
+        URI("file://#{path}").to_s
+      end
+    end
+
+    def derivative_dir
+      File.split(derivative_path("dummy"))[0]
+    end
+
+    def derivative_path destination_name
+      CurationConcerns::DerivativePath.derivative_path_for_reference(self, destination_name)
+    end
+
+
+  end
+end

data/app/services/samvera_hls/hls_output_file_service.rb

@@ -0,0 +1,10 @@
+require 'samvera/derivatives'
+module SamveraHls
+  class HlsOutputFileService < CurationConcerns::PersistDerivatives
+    def self.call( directives,temp_dir)
+      hls_dir =  directives[:path]
+      FileUtils.mkdir_p(hls_dir)
+      FileUtils.move(Dir.glob(temp_dir+"/*") , hls_dir)
+    end  
+  end
+end

data/app/views/_playlist.html.erb

@@ -0,0 +1,7 @@
+<audio controls="controls" class="hls-media" preload="auto">
+    <% file_sets.each do |file_set| %>
+        <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    <%end %>
+        Your browser does not support the audio tag.
+</audio>
+<script type="text/javascript">isPlaylist = true</script>

data/app/views/curation_concerns/file_sets/embed.html.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <meta title="media">
+        <%= javascript_include_tag "embed" %>
+        <%= stylesheet_link_tag "embed" %>
+    </head>
+
+    <body>
+        <%= render @media_partial %>
+    </body>
+</html>

data/app/views/curation_concerns/file_sets/media_display/_audio_hls.html.erb

@@ -0,0 +1,5 @@
+<audio controls="controls" class="hls-media" preload="auto" width="100%" height="100%">
+    <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    Your browser does not support the audio tag.
+</audio>
+

data/app/views/curation_concerns/file_sets/media_display/_video_hls.html.erb

@@ -0,0 +1,5 @@
+<video class="hls-media" preload="auto" width="100%" height="100%">
+    <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    Your browser does not support the video tag.
+</video> 
+

data/app/views/file_sets/embed.html.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <meta title="media">
+        <%= javascript_include_tag "embed" %>
+        <%= stylesheet_link_tag "embed" %>
+    </head>
+
+    <body style="margin:0px;">
+        <%= render @media_partial %>
+    </body>
+</html>

data/app/views/file_sets/media_display/_audio_hls.html.erb

@@ -0,0 +1,5 @@
+<audio controls="controls" class="hls-media" preload="auto">
+    <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    Your browser does not support the audio tag.
+</audio>
+

data/app/views/file_sets/media_display/_video_hls.html.erb

@@ -0,0 +1,5 @@
+<video class="hls-media" preload="auto">
+    <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    Your browser does not support the video tag.
+</video> 
+

data/app/views/hyrax/file_sets/embed.html.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <meta title="media">
+        <%= javascript_include_tag "embed" %>
+        <%= stylesheet_link_tag "embed" %>
+    </head>
+
+    <body>
+        <%= render @media_partial %>
+    </body>
+</html>

data/app/views/hyrax/file_sets/media_display/_audio_hls.html.erb

@@ -0,0 +1,5 @@
+<audio controls="controls" class="hls-media" preload="auto" width="100%" height="100%">
+    <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    Your browser does not support the audio tag.
+</audio>
+

data/app/views/hyrax/file_sets/media_display/_video_hls.html.erb

@@ -0,0 +1,5 @@
+<video class="hls-media" preload="auto" width="100%" height="100%">
+    <source src="<%= File.join(request.base_url,"file_set",file_set.id,"hls.m3u8") %>" type="application/x-mpegurl"/>
+    Your browser does not support the video tag.
+</video> 
+

data/config/hls.yml

@@ -0,0 +1,49 @@
+---
+video:
+     hls_high:
+          bitrate: 6500000 
+          maxrate: 6800000 
+          vf: "scale=1280:-2"
+          resolution: "1280x720"
+     hls_med:
+          bitrate: 3500000
+          maxrate: 3600000 
+          vf: "scale=960:-2"
+          resolution: "960x540"
+     hls_low:
+          r: 15 
+          profile_v: baseline 
+          level: 3.0 
+          bitrate: 400000 
+          maxrate: 420000 
+          g: 45 
+          segment_list_type: m3u8 
+          vf: "scale=480:-2"
+          codec_code: "mp4a.40.2,avc1.42001e"
+          resolution: "480x360"
+     default:
+          r: 29.97 
+          pix_fmt: yuv420p 
+          vcodec: libx264
+          acodec: aac
+          profile_v: main 
+          level: 3.1 
+          codec_code: "mp4a.40.2,avc1.4d001f"
+          segment_time: 9
+          g: 90
+          vf: "scale=960:-2" 
+audio:
+     hls_hd:
+          bitrate: 128000
+          maxrate: 140000
+     hls:
+          bitrate: 64000
+          maxrate: 70000
+     default:
+          acodec: aac
+          flags: "-f segment -global_header" 
+          segment_time: 9
+          segment_format: mpeg_ts 
+          segment_list_type: m3u8 
+          codec_code: "mp4a.40.2"
+          resolution: 300x50

data/config/routes.rb

@@ -0,0 +1,7 @@
+Rails.application.routes.draw do
+  
+  get '/file_set/:id/hls.m3u8', to: 'file_sets#master'
+  get '/file_set/:id/:format/variant.m3u8', to: 'file_sets#variant'
+  get '/file_set/:id/embed', to: 'file_sets#embed'
+  
+end

data/lib/generators/samvera_hls/install/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Installs samvera_hls into your rails application.
+      * adds the routes to playlist files
+      * adds hls derivative file creation
+      * installs new viewer for adaptive streaming display
+
+Example:
+    rails generate samvera_hls:install