9.3. Uploading Videos in Studio

After a video administrator works with edX partner support to complete preliminary setup for the entire institution, individual course teams can begin to upload video files for their courses in Studio. This section describes the specifications met by successful video files, the steps to upload the files, and how you monitor video processing at edX.

The result of video processing is additional file formats that are transferred to multiple hosting services (YouTube CMS and Amazon AWS), ready for learners to access.

9.3.1. Specifications for Successful Video Files

Your videos can contain whatever content you want to include in the course.

Important

Each video file that you upload must be less than 5GB in size.

The Creating Videos section of edX101 Overview of Creating an edX Course has some helpful pointers for creating good video content.

9.3.1.1. Maximum Video File Size

The maximum size for each video file that you upload is 5 GB. The upload process fails for larger files.

9.3.1.2. Supported Video Formats

The automated processing that takes place at edX transforms each of your uploaded video files into several different formats. For this process to succeed, you must upload videos in .mp4 or .mov format.

9.3.1.3. Compression Specifications

For best results, your video files should have these compression specifications.

Codec & Container H.264, .mp4
Resolution & Frame Rate 1920x1080, progressive, 29.97 fps (see note)
Pixel Aspect Ratio 1.0
Bit Rate VBR, 2 pass
Target VBR 5 mbps
Max VBR 7.5 mbps
Audio AAC 44.1 / 192 kbps
Size 5GB maximum

Note

Typically you export at the same frame rate that was used when you created the media file. For example, if you create the file in a country that uses the PAL system, you export at 25 fps instead of the NTSC standard of 29.97 fps.

9.3.1.4. File Naming Conventions

Each video file must have a unique name. The edX partner support team recommends that organizations define a naming convention for video files, and apply it to videos for all courses. At a minimum, your naming convention should include these elements.

  • A course identifier.
  • The year of the initial course run.
  • A revision or version number.

An example naming convention is {course}_{year}_{segment}_{learning sequence}_{revision}.{type}, which results in file names like SPU27_2015_S1_1_0.mp4.

Video file names should include alphanumeric characters and underscores only. Periods should be used only to separate the file name from the extension that identifies its type.

Standardizing the content and format of these file names helps all interested parties identify and track video files over time.

9.3.2. Upload Video Files

Before you can upload video files, the video upload feature must be enabled for the course. Your video administrator coordinates this task with the edX partner support team. See Create YouTube Channels.

  1. Open the course in Studio.

  2. Select Content, then Video Uploads.

  3. Add video files to the Video Uploads page. You can drag files to the page and drop them, or click Select files to locate the files to upload.

    A rectangular tile appears on the page for each file. The file name, a progress bar, and the status of the file upload process appear in the tile.

Important

You must leave the Video Uploads page open in your browser until the upload process is complete for all files.

When the status of an uploaded file changes to “Ready”, the file upload process is successful. If the status of an upload is “Failed”, the file upload process was not successful. The duration of a video is listed as “Pending” until the process determines the duration.

You can monitor file progress by checking statuses on the Video Uploads page or by downloading a report.

9.3.2.1. Remove Videos from the Video Uploads Page

A list of every file that you uploaded to the edX servers appears in the Previous Uploads section of the Video Uploads page. You can remove videos from the Previous Uploads list without affecting course content that uses the video ID of successfully uploaded videos.

To remove a video from the Previous Uploads list, follow these steps.

  1. Open the course in Studio.

  2. Select Content, then Video Uploads.

  3. In the Previous Uploads list, locate the row for the video that you want to remove, then select the “X” icon in the Action column.

  4. In the confirmation dialog box that appears, select Remove to remove the video.

    The selected video is removed from the Previous Uploads list. Course content that uses the video ID of the removed video is not affected.

9.3.3. Monitor Video Processing

After your video files successfully reach the edX servers, automated processing begins.

Note

Automated processing takes up to 24 hours to complete.

A list of every file that you attempt to upload to the edX servers appears in the Previous Uploads section of the Video Uploads page. The list includes each file’s status in the encoding and hosting workflow. In addition, you can download a report of the video files that you uploaded. See Downloading the Available Encodings Report.

9.3.3.1. Video Processing Statuses

The encoding and hosting process assigns these statuses to video files.

  • Uploading files have not yet reached the edX servers successfully. For files that encounter a problem, verify that the file that you uploaded is in .mp4 or .mov format and meets the other specifications for successful video processing. See Specifications for Successful Video Files. Then try uploading the file (or its replacement) again.
  • In Progress files are undergoing processing to create additional file formats or waiting for successful transfer to the host sites.
  • Uploaded files have successfully completed uploading to the edX servers.
  • Ready files are ready for inclusion in your course and for learners to view. See Adding Videos to a Course. When you click the names of these files, a file hosted on one of the external host sites plays. Processing continues at video hosting sites for 24 hours after you upload a file.
  • Failed files did not complete processing successfully. Verify that you can play your original .mp4 or .mov file and that it meets the other specifications for successful video processing. See Specifications for Successful Video Files. Upload the file, or a replacement file, again. If processing fails more than once for a file, contact edX partner support at partner-support@edx.org.
  • Failed Duplicate is the status for files that failed to upload because the system identified them as duplicates.
  • Invalid Token or Unknown indicate a configuration problem. Inform edX partner support if these statuses appear.

For more information, see Video Encoding and Hosting Overview.

9.3.3.2. Downloading the Available Encodings Report

The Available Encodings report provides detailed information about the video files that you have uploaded. This report includes the status of the encoding and hosting process for each video file that you have uploaded, the identifier for the video, and the URLs for each encoding format. The Available Encodings report is a comma separated values (.csv) file that you can view in a spreadsheet application or text editor.

To download the Available Encodings report, follow these steps.

  1. Open the course in Studio.
  2. Select Content, then Video Uploads.
  3. Click Download available encodings (.csv).
  4. Use a spreadsheet application or text editor to open the .csv file.

The .csv file includes the following columns.

  • The file Name.
  • The file Duration. If the upload process has not yet determined how long the file is, Pending appears in the Duration column for a video.
  • The Date Added, which shows the date and time that you uploaded the video file.
  • The unique, identifying Video ID. When you add a video component to your course, you supply the video ID for the file you want to add. See Adding Videos to a Course.
  • The Status of the encoding and hosting process for the file. See Video Processing Statuses.

The .csv file also includes a column for each of the formats that are the result of the edX encoding and hosting process. These columns include the URL of a host site only after the format is successfully generated and delivered to its destination.

  • desktop_mp4 URL: The AWS location of a 720p resolution video file in mp4 format. This file is delivered to learners who do not have access to YouTube and view course videos with mp4 players.

  • desktop_webm URL: The AWS location of a 720p resolution video file in webm format. This file is delivered to learners who do not have access to YouTube and view course videos with webm players.

    The encoding and hosting process no longer creates webm versions of the video files that you upload. Modern web browsers do not require the webm format. The .csv file includes the desktop_webm URL column to show the webm URLs for videos uploaded before this change. When you upload a new video, the column will remain empty, even after the encoding and hosting process is complete.

  • mobile_low URL: The AWS location of a 360p resolution video file. This file is delivered to learners who download and view course videos on mobile devices.

  • youtube URL: The YouTube location of a 1080p resolution video. By default, the edX video player delivers this video.

The edX encoding and hosting process produces these alternative formats to ensure optimal playback quality for your learners.