Embedding Repository Videos in Websites

One of the useful features of the OIT Media Repository and Media Management System is the ability to embed a streaming video into a website.  There are a few important things to know about this process before you attempt to implement it.

Embedding a video means to include code on a web page that places a video player within the other visible content on that page.  The player is configured to play a video file that could be hosted either locally or on another server.  So, embedding consists of two parts: the source content, and the embeddable video player module.

Source Content

Before embedding any video content on a web page, you should make certain that the content is licensed to be shared publicly.  If you created the content, then this should not be an issue, unless your department places restrictions on the content that you create for them as part of your job, research, or school work.  If someone else created the content, then you should check with that person to determine any applicable copyright issues and licensing requirements.  Users of the OIT Media Repository and Media Management System are solely responsible for determining video content copyright requirements and ensuring compliance with those requirements.   In accordance with applicable copyright laws, OIT reserves the right to disable access to or remove any content upon receipt of a valid complaint that identifies such content as infringing on another party's copyright.

Embeddable Video Player

While it is possible to just provide a link directly to a video file and hope that the end user of your website has a video player installed that can handle that video, the most common practice is to put a video window directly into a web page so that the video plays inline with other page content.  For this to work, the end user still has to have an appropriate video player plug-in installed in his/her web browser, but it is usually easier for an end user to install or update a browser plug-in then to install or update a stand-alone player application.

To embed an MP4 video file stored in the OIT Media Repository environment, you will need an embeddable video player that supports MP4 playback over RTMP (the Abode Flash streaming format).

Please note that most embeddable video players that work with MP4s via RTMP will require the end user to have Adobe Flash Player installed in his/her web browser. However, this is a very commonly used browser plug-in, so the vast majority of your end users will likely have it already, and for those who don't, many browsers provide easy-to-follow guidance for downloading and installing this common plug-in.

How to Embed a Video File from the OIT Media Repository

  • Embedding on an Official Georgia Tech Website

    OIT has chosen to license the Longtail Video embeddable video player JWPlayer for Georgia Tech website use only.  This is defined as a website either hosted on a server with a .gatech.edu FQDN, or being owned and run by Georgia Tech and bearing a version of the official Georgia Tech logo on prominently on its front page.  Users who wish to embed videos from the OIT Media Repository on websites that do not meet this criteria should see the next section for more information.

    For Official Georgia Tech Websites, the easiest way to embed an MP4 video file hosted in the OIT Media Repository is to use the sample code provided in the Media Management Console.  That code can be found by selecting the video file on the Mangae Subzone Content page, then selecting the "How to Share" button from the control panel.  The "How to Share" page will generate HTML code for embedding that specific file that you can cut-and-paste into your website page.  This code utilizes one of the newest features of JWPlayer to be able to automatically detect browsers that do not support Flash (such as on iPods, iPads, iPhones, Android devices, etc.) and provide an HTML5 compliant video player to those devices.

    Please note that under Longtail Video's license, you cannot copy the JWPlayer files to any other webserver, even other Georgia Tech webservers.  You may only embed the player by linking to the official copy of the player hosted on the OIT Digital Media Initiatives web server, as done in the sample code provided in the Media Management System.

    Embedding video content that was created in formats other than the MP4 format is possible, but requires different code and in most cases a different embeddable player.  At this time, OIT does not supply standardized code for embedding other video file formats.

  • Embedding on Other Websites

    As mentioned above, the copy of JWPlayer that OIT has licensed can only be used on official Georgia Tech websites.  Anyone wanting to embed video on a website that does not meet the criteria outlined in the previous section can not embed OIT's licensed copy of JWPlayer.  Please understand that this does not restrict you from embedding the video content itself in a non-campus website - it just means that a different embeddable video player must be used.

    Fortunately, Longtail Video provides a different "unlicensed" version of JWPlayer that can be used on any non-commercial website.   If your non-campus website is non-commercial in nature, then the easiest solution is to download the "unlicensed" JWPlayer and install it on your webserver under the URL path /jwplayer/.  You can then cut-and-paste the alternate embedding code available on the "How to Share" page of the Media Management Console (look for the link to "alternate instructions" in the second paragraph on that page).

    If your non-campus server is of a commercial nature, then you will need to purchase a license for JWPlayer.  Once you have bought your license, you'll be able to download a copy of the "licensed" player, install it to your local server and implement the alternate embedding code as described in the previous paragraph.

    There are other embeddable MP4 players available that could be used in place of JWPlayer, but there are none known to be completely free for use on any website.  Most either have a licensing model similar to Longtail's, or can only be used with a purchased license.   Due to the inherent uniqueness of every player, OIT cannot provide any support or assistance with implementing video embedding with any product other than Longtail's JWPlayer.