Hola Media Player API

An HTML5 Media Player that instantly streams http, torrents and magnets to the browser.

Live demo

<script src="//hola.org/play_page.js"></script>
<div class="hola-embedded-player"
  v="http://distribution.bbb3d.renderfarming.net/video/mp4/bbb_sunflower_1080p_30fps_normal.mp4.torrent">
</div> 

Features

• instant streaming
• protocols: http, torrent files and magnet links
• no software installation for http links
• embeddable as div, iframe, script or simple link to video
• video formats: mp4, mkv and avi
• browsers: Chrome, Firefox, IE, Safari
• mobile: Android App. comming soon: mobile browsers
• mobile: coming soon: Android App.
• seek/reposition
• subtitles

** Please note that the use of the Hola Player is subject to its terms of use, available on http://hola.org/legal_publishers

<a> link

<a href="http://hola.org/play#v=http%3A%2F%2Fdistribution.bbb3d.renderfarming.net%2Fvideo%2Fmp4%2Fbbb_sunflower_1080p_30fps_normal.mp4.torrent">
  Watch SunFlower Movie
</a>

Live demo

<script> and <div>

<script src="//hola.org/play_page.js"></script>
<div class="hola-embedded-player"
  v="http://distribution.bbb3d.renderfarming.net/video/mp4/bbb_sunflower_1080p_30fps_normal.mp4.torrent">
</div> 

Live demo

<iframe>

<iframe width="770" height="500" frameborder="0" allowfullscreen
  src="//hola.org/play_embed#v=http%3A%2F%2Fdistribution.bbb3d.renderfarming.net%2Fvideo%2Fmp4%2Fbbb_sunflower_1080p_30fps_normal.mp4.torrent">
</iframe>

Live demo

make all torrent and magnet links pop up a media player upon hover

<script src="//hola.org/play_page.js"></script>
<script>window.hola_player.init({links: 'hover'});</script>

Live demo

HTTP streaming

Instant streaming of MP4 files without any client-side software installation

• Live demo
• Live demo

Responsive player

Fit player to available space

• Live demo

Multiple video quality options (HD mode)

• Live demo

Subtitles

Supported formats:

• srt
• vtt
• srt/vtt inside a zip file

Language detection:

• Auto detection from subtitles file name. If the file name contains any 2/3 letter language abbreviation (eg. en.srt, eng.srt, fr.srt,...) we will use it as the subtitles language.
• Force explicit subtitles lanaguge: sub1=en,xxx.srt (you can use any 2/3 letter lanaguage abbreviation)

<iframe src="//hola.org/play_embed#v=xxx.torrent&sub1=eng.srt&sub2=fr.srt"></iframe>

Live demo

<div class="hola-embedded-player" sub1="eng.srt" sub2="fr.srt"></div>

Live demo

Subtitles from json

It is possible to specify a json with multiple subtitles options in different languages. Example:

{
    "subs": {
        "vid10001": {
            "english": [
                {
                    "url": "https://durian.blender.org/wp-content/content/subtitles/sintel_en.srt"
                }
            ],
            "spanish": [
                {
                    "url": "https://durian.blender.org/wp-content/content/subtitles/sintel_es.srt"
                }
            ]
        }
    }
}

• Json example
• Live demo

Subtitles plugins

It is possible to specifiy subtitles plugin for automatic subtitle download:

• json plugin
• xmlrpc plugin

Add hola_player.json to the root of your site domain to set plugins. It is also possible to explicity set a config json to your video using config_url=http://

hola_player.json example

Subtitles json plugin

Set OPEN_VIDEO_ID=id to your video and hola will automatically download the subtitles.

{
    "plugin": [
        {
            "type": "json",
            "subtitle_url": "http://hola.org/player/api/{OPEN_VIDEO_ID}"
        }
    ]
}       

• Live demo

Subtitles xmlrpc plugin

API parameters

parameters formatting

• url (link or iframe src): http://hola.org/play#v=...&param1=...&param2=...&param3=... (all params values must be uri-encoded)
• div parameters: <div class="hola-embedded-player" v="..." param1="..." param2="..." param3="...">

v=VIDEO_SOURCE

• v=http://../clip.mp4 - http that holds mp4/mkv/avi video
• v=http://../clip.mp4.torrent - torrent that holds mp4/mkv/avi video
• v=magnet:... - magnet link that holds mp4/mkv/avi video

sources=MULTIPLE_SOURCES

• sources=MULTIPLE_SOURCS - where MULTIPLE SOURCES is encodeURIComponent(JSON.stringify(array)) and array = [{file: 'http://.../clip.mp4', label: '720'}, {file: 'http://.../clip4_2.mp4, label: '480'}]

title=VIDEO_TITLE

• title="Video Title" - set the video title. if not specified, auto-detect video title (from file name, torrent info)

player_type=html5/flash

• player_type=html5 - use html5 player (default)
• player_type=flash - user flash player

cdn=0/1 (http only)

Offload http downloads from your CDN to Hola's P2P network, and improve performance by receiving content from many peers. This can reduce bandwidth up to 80%, and eliminate buffering. Users will get an option to add to their browser the Hola engine that connects to the Hola P2P network.

• cdn=0 - player will retrieve video from http source (default).
• cdn=1 - player will attempt to retrieve video from Hola P2P CDN, resulting in bandiwdth savings and no buffering.

responsive=0/1

• responsive=0 - default, player size is static
• responsive=1 - player size depends on iframe size

poster=POSTER_URL

• poster=http://../poster.png - url for the video poster image
  Live demo

autoplay=0/1 (coming soon)

• autoplay=0 - default, don't auto start playing the video
• autoplay=1 - auto start playing the video

start=START_SEC (coming soon)

• start=100 - start playing video 100sec after video start

start_at=START_PERCENT

• start_at=10 - start playing video 10% after video start

duration=DURATION_SEC (coming soon)

• duration=3600 - set the video duration to be used before the video information is retrieved

sub=SUBTITLES_SOURCE

• srt subtitles from http source: sub=http://../clip_subtitles.srt
• srt inside zip: sub=http://../clip_subtitles.zip
• multiple subtitles: sub1=http://... sub2=http://... sub3=http://...
• explicit subtitles langauge : sub=en,http://...
• subtitles json: sub=json,http://...

sub_default=VALUE

• automatic selection of subtitles (use previous user selection, default to browser locale): sub_default=on
• explicit subtitle language: sub_default=en
• subtitles off: sub_default=off

config_url=JSON_URL

• explicit set configuration url: config_url=http://...
• put hola_player.json at the root (http://site/hola_player.json) of your site

Events

• hola_vjs.play
• hola_vjs.pause
• hola_vjs.ended
• hola_vjs.loadedalldata
• hola_vjs.playing
• hola_vjs.timeupdate
• hola_vjs.durationchange
• hola_vjs.progress
• hola_vjs.fullscreenchange
• hola_vjs.error
• hola_vjs.volumechange
• hola_vjs.waiting
• hola_vjs.qualitychange