Uploading Videos Using the Upload Module
This topic provides an overview of the Upload module which is used to upload videos to a Video Cloud account.
The Upload module uses a dynamic ingest process to retrieve and transcode video content. When you select a file to upload, Video Cloud uses a pull-based process to pull the content from a storage location where it then uses the Zencoder transcoding service to transcode the content.
To access the Upload module, click Upload in the navigation header.
Supported video formats
For information about video formats and codecs, and what source video formats are supported by Video Cloud, see Supported Video Codecs and Containers
Selecting an ingest profile
Before uploading videos, select an ingest profile. The ingest profile contains the transcode settings that will be used when the videos are transcoded. The list of available ingest profiles will vary based upon how your Video Cloud account is configured. In the following screen shot, both CONTEXT AWARE ENCODING and DYNAMIC DELIVERY profiles are available.
Note: To learn more about Dynamic Delivery, see Overview of Dynamic Delivery.
The video renditions that are created are based upon the ingest profile that is selected. For specific details on the Brightcove supplied ingest profiles, see one of the following documents:
- LEGACY (or if no groupings are displayed - See Standard Ingest Profiles for Legacy Transcoding
- DYNAMIC DELIVERY and CONTEXT AWARE ENCODING - See Standard Ingest Profiles for Dynamic Delivery and Context Aware Encoding
The image dimensions for the poster and thumbnail images are based upon the image dimensions specified in the ingest profile.
Note: For information on creating additional ingest profiles, or setting a default profile for your account, see Managing Ingest Profiles.
Note: Before uploading videos, make sure the appropriate ingest profile has been selected.
Videos can be uploaded using one of these methods:
- Drag and Drop - Drag files from the file system to the Upload module page. The entire page below the navigation header becomes the drop zone. When the file is dropped, the upload process will begin.
- File selection dialog - Click Browse for Videos to open a file selection dialog and then browse and select files to upload.
- Remote URL - Click Enter URL to specify the location of the source file. Source files may reside on a public Dropbox folder or Amazon S3 storage location. Click Process Video when finished.
- There is no file size limit. Brightcove has tested with uploads as large as 100GB without any issues.
- When uploading large files, Brightcove recommends setting the Upload Queueing setting to Upload one file at a time.
- If you receive Studio timeout errors when uploading large files, try uploading the file to S3 or some other remote storage location and use the URL upload option in the Studio.
- You can not use a Google Drive or YouTube URL, because they do not generate direct links to video files.
- When uploading from Dropbox, if the URL ends with "?dl=0", you may need to change it to "?dl=1" before the file will upload.
- Video file names (including the extension) must not exceed 120 single-byte (60 double-byte) characters. If it does, the video will be ingested successfully, but you will not be able to retranscode it later.
Once the files have been selected, the file upload will begin. To cancel the upload, click Cancel Upload. Click Dismiss to remove the file entry from the page. While uploads are in a processing state, do not close or move away from the browser window. Doing so may cause an incomplete upload.
When the upload is complete, a Processing Complete status will display. This indicates the processing has completed and it is safe to navigate from the Upload module.
Click Edit to view the ingest profile and a subset of the video properties. The ingest profile can be changed if the video transcoding has not started. The following video properties can be edited:
- Status - Video status
- Active - Video can be played
- Inactive - Video can't be played
By default, when a video is uploaded, the status is set to Active unless required fields are missing. If required fields are missing, a message will be displayed with the required fields highlighted in red. Videos with missing required fields can still be uploaded but they will remain Inactive until all of the required fields have values. For more information on working with required fields, see Setting Required Fields for Videos.
Note: There is an account level setting, Default to Inactive, which can be used to set all uploaded videos to be inactive. For more information, see Managing Account Settings.
- Name - Title for the video
- Short Description - Short description for the video
- Tags - Tags associated with the video
- Reference ID - Video reference ID
- Video Projection - Select 360 Degree to indicate a video is a 360 degree video. For more information on working with 360 degree videos, see Working with 360-Degree Videos.
- Enable offline playback - When checked, enables the video to be saved locally and viewed offline when using applications created using the device SDKs. This option will only appear if the account is enabled for offline playback. It is recommended to only set this option when using Advanced upload (when user must manually start upload processing). Setting this when a video is in the process of uploading may cause issues.
- Move to Folder - Select a folder to assign the video to. For more information on working with folders, see Organizing Videos Using Folders.
- Custom Fields - Any custom fields that have been marked as required will appear.
To learn more about video properties, see Editing Video Properties using the Media Module.
Click Save to save any changes and begin the transcoding process.
Using advanced upload
When the Advanced Upload account setting is enabled, the video properties panel will also display Select buttons allowing poster and thumbnail images to be uploaded along with the video. Click Select to choose poster and thumbnail images and then click Process to begin the transcode.
Note that the image dimensions for the poster and thumbnail images will be based upon the image dimensions specified in the ingest profile. For information on configuring the Advanced Upload account setting, see Managing Account Settings.
Setting a default folder and tags
When uploading videos, a folder and tags for the videos being uploaded can be specified. The folder dropdown list will display a list of all the folders that have been created in the Media module. Click + Create Folder to create a new folder and assign the video(s) to the new folder. When creating a new folder:
- Name is limited to 100 characters
- Folder names must be unique within an account
- Illegal character: /
When a folder is selected, all uploaded videos will be added to that folder. For information on creating and assigning videos to folders using the Media module, see Organizing Videos Using Folders.
Tags can also be assigned to videos as they are uploaded. Enter a comma-separated list of tags to assign to videos.
After selecting a folder or adding tags, click Apply to All to save the changes. Note that the folder and tags will be applied to all videos that are uploaded, in the process of being uploaded or where the upload has finished and the video is still displayed in the Upload module (Dismiss button hasn't been clicked).
Uploading videos from mobile devices
The Media module is written entirely in HTML5 and can also be used on tablet and mobile devices. This allows you to shoot video with a mobile device and upload it to your Video Cloud account. To upload content from a mobile device, open the Upload module and select an ingest profile. When you click Browse for Videos, the photos application on the device will open. Select the videos to upload and click done. The videos from the mobile device will begin uploading and the progress will be displayed on your device.
If you are providing a URL for Video Cloud to fetch your videos, and you are sending credentials as part of the URL, you need to percent-encode certain reserved special characters:
/* unencoded */ ftp://email@example.com:firstname.lastname@example.org/path/to/input.mp3 /* encoded */ ftp://user%40example.com:email@example.com/path/to/input.mp3
Common upload errors
The difference between the request time and the current time is too large.
This error will occur when the system time on the machine uploading videos is not set correctly. This usually happens after a time change. Make sure your machine is set to the correct time.