Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Multimedia Manager is a useful tool for organizing your audio and video multimedia files for a CommCare application. It allows you to upload, preview, and replace your audio and image files, verify that no files are missing, and enables one-click download of all your media files, with the correct file names.  When preparing your media files, be sure to follow the guidelines on the CommCare help site for audio and image file types and sizes.

You can add multimedia in the Form Builder, or you can add them in the Multimedia Manager

STEP 1: Adding a multimedia reference 

Inside the form builder, chose the question or label where you want an image to be displayed, or from which you want an audio file to be playable.  

In In the Question Properties box , under Content, you will see find a section called Media which presents the option to add various types of media or properties.  The first two buttons are "image" and "audio," as you can see below: Image Removedimage, audio, or video files:

Image Added

If you click on either any of these buttons, you will see a file-path automatically generated under each language's display text.  

Here we have clicked on both image and audio, so both languages get a file-path:

Image Removed. Here you can see what the Media section looks like with an image file-path added:

Image Added

At this point you have the option of uploading an image direction into the form builder. Alternatively, you can just leave this reference and add the media through the Multimedia Manager. Note that if you add a reference but do not add a media file, your application will show the file-path instead of any image, so it is important to upload files for each reference you create. Don't worry, this is why the Multimedia Manager is there.

You can remove the reference by clicking on the red X.

You can also manually change the file-path by clicking on the Advanced: Show Path button.

Image Added

Each language of display text gets its own set of file-paths in case you want separate files, so this can be useful when you want to use different images for each language.  However, by default the automatically generated file-paths are the same for all languages; you'll have to manually adjust them if you want support for more than one language (contact Dimagi for help).  The file path automatically uses the Question ID, so here is what it looks like for an image for the question labeled hemoglobin_low_counsel

...

Images are automatically given the file type "png" and audio files "mp3"To remove a multimedia reference, simply click on the big red "delete" button.

 

STEP 2: Uploading Files

Note that it is not necessary that you use the Multimedia Manager for this.  If you prefer, you can manually name all of the media files,  and put them in the correct file pathpaths, and load the files onto the phone.  However, we strongly suggest using the multimedia manager as it minimizes management tools built into CommCare as they minimize the risk of confusion around names of filesfilenames.

Before you use the multimedia manager, make sure that you have followed Step 1 for all files that you want to upload. For example, if your application will will have 15 images and 10 audio files, make sure that 25 separate file paths have been generated. If you are reusing images, make sure that they have the same file path. That means that for any question for which you want a media file, you should have added the reference in the form builder.

You can add files directly in the form builder, if you choose to. If you do that, you will be able to see the files you have uploaded when viewing the Multimedia Manager.

You can find the Multimedia Mangaer for your application on the main application settings page.  Scroll down and after clicking on "Multimedia" you will see the following:

...