...
You can add multimedia in the Form Builder, or you can add them in the Multimedia Manager.
| Table of Contents |
|---|
Introduction Video
Watch introduction video for Multimedia Manager
| Widget Connector | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Excerpt |
|---|
STEP 1: Adding a multimedia reference
  3. If you click on any of these buttons, you will see a file-path automatically generated. Here you can see what the Media section looks like with an image file-path added:  4. 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. 5. You can remove the reference by clicking on the red X. 6. You can also manually change the file-path by clicking on the Advanced: Show Path button. 7. Save the Form when you've finished your changes.  Note: You can also add multimedia (image, audio) in the module menu and the form menu using the same instructions found above for adding multimedia to a form. |
...
STEP 2: Uploading Files
Option 1: 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. To upload a file, simply click on "Upload Image/Video/Audio" button in the Media Section of Question Properties.
The filename of any file uploaded in the form builder will be randomized so it does not collide with other media in the application. If you want to assign a custom path, for example: when adding media for different languages, you must first assign the path in the form builder (but do not upload the file), and then use the Multimedia Manager (see below) to upload images for custom paths assigned in the form builder.
Option 2: Multimedia Manager - Manual Upload
...
You can find the Multimedia Manager for your application within the Settings section. The settings icon is to the right of the Project name and the Multimedia section is the second tab. After clicking on "Multimedia" you will see the following:
...
You will use "Download ZIP" later to grab all of your files at once. Below that there might be a note about how many references are missing files. Click on the blue "Multimedia Reference Checker" button to upload files for all the references.
A new window will open that will look like this:
...
Again, you can see if you have missing files, and have the option to download a ZIP of all the multimedia files.
Let's try uploading an image file.
If you have not yet uploaded any files, after clicking on "Show Only
...
Missing References" you will see a list of images that still need to be added:
...
2. The manager alerts you that each file is missing, and you will need to select the red button "Upload Image." There is one row for each missing file. After clicking on "Upload Image" you will see something like this:
...
3. Click on "Select File" to find the appropriate file on your computer. 
...
4. After you select a file, you will have the option to "Select another file" if it was not the correct file or to "Begin Upload."
5. After you have uploaded the media file, your list will no longer have orange "missing" tags, but green "found" tags. It should look more like this:
...
6. As you can see, your options from the Multimedia Manager have now changed. You can preview the file by selecting "View Larger," to open the file in a new window (you'll have to open a new window to hear an uploaded audio file!). If you want to change the image, click on "Replace Image" and follow the same instructions as before.
...
In order to bulk upload your multimedia, you will need to do the following:
...
Label your multimedia files with the relevant question ID eg. if question ID=woman_name, then label the audio/image file as woman_name
Once all your multimedia files are correctly labeled (with the relevant question ID), you now have the option to bulk upload your files (images/audio/video)
Place all your images/audio files into a directory structure that mirrors the file path
You can see the file path in the Media section of the form builder by clicking on Advanced Show path (see below)
In the example below, the file path for the audio file is
...
file/commcare/audio/data/show_edd
In the below example, the file path for the image files is file/commcare/image/data/show_edd
...
5. Click on Multimedia tab in the setting section of CommCare HQ (see below)
...
6. You can now click on multimedia reference checker.
...
8. Now click on Select Files and then Begin upload (see below)
...
Bulk uploading multimedia for an app with multiple languages:
1. Go to the media section for a relevant question in your form
2. Click on the relevant section audio/video and you will see something like the below
...
(You will notice that the file path for the audio file is the same for French and English)
3. You will need to modify the file paths for the audio files in the form
...
You should then be able to follow the steps above for bulk upload!
STEP 3: Download Your Media Files!
In the release manager of your application after clicking "deploy"
The file will be downloaded as a ZIP and you will have to unzip the file in order to use it. By storing and transmitting it as a ZIP is a good idea so that you don't lose any of those media files!