Media Folders and Record Folder

Media files imported or recorded within Livegrade are stored in a designated “Media Folder”. Each project uses one media folder as the current “Record Folder.” When you import new media files or generate new recordings within Livegrade, the corresponding media files are saved into the currently set record folder.

Media folders and the current record folder are project-depending settings. Consequently, it makes sense to use a separate media folder/record folder for each project.

You can set the record folder when creating a new project or change the record folder in the “Recording” preferences. The default parent directory for project Media is “Livegrade Media” in ~/Movies.

“New Project” window with suggested record folder


Unique media folder references and media status

Each Livegrade media folder contains a “LIVEGRADE-ASSET-FOLDER.json” file holding an UUID for unambiguous referencing of media assets in Livegrade projects.

JSON file in media folder holds UUID

Note: Livegrade detects a media folder by reading the UUID stored in the JSON file of the folder. Make sure that the corresponding JSON file always remains in its media folder. 

When you change a project’s media folder in the recording preferences, Livegrade automatically detects the UUID of the new media folder and reconnects any matching media if the project holds media files that are associated with the UUID.

Removing a media folder that contains project media files results in an offline media status for the associated shots. When you add a matching media folder again, offline media files reconnect immediately, also if the directory was renamed or moved in Finder or it is a copy of the original directory on another drive.

You can see if a media file for a shot is offline by checking the opacity of the type icon in the shots table or the info tab. A light-grey “Media Offline” image indicates the offline media status also in the info tab and in slots using the media as current image source.

Shots with offline media status

The offline media status of media folders (and volumes) is also indicated by a lower opacity of the rows in the table of the recording preferences.

Offline media folder in recording preferences

Livegrade’s media storage system also allows sharing Pomfort look archives (.pfla), including media; see Sharing look archives with media.

Progress bar for monitoring media import/export tasks

You can monitor running media import or media export jobs in the progress bar. If required you can cancel running jobs. All jobs are also canceled automatically when you quit Livegrade and will not be resumed when Livegrade is opened again.

Note: Already copied files will not be deleted after canceling a job. Make sure to delete redundant files manually in the Finder if necessary.

Progress bar indicates status of running import/export jobs


Multiple media folders

Livegrade Pro is limited to one active media folder (record folder) per project, while Livegrade Studio also supports using multiple media folders in one project simultaneously:

In Livegrade Studio you can add multiple media folders to the same project. In the media folders table of your project’s recording preferences you can add and remove media folders. One media folder can be made the current record folder. You can remove all media folders with the exception of the currently set record folder. When importing PFLAs with media you can add the corresponding media folder to your project’s recording preferences and use it immediately without copying the files to your record folder. Learn more about Sharing look archives with media.

Recording Preferences Livegrade Studio

Note: When adding a media folder from another project to your project’s recording preferences and you delete shots and the associated media files within one of the projects, the files will be offline in both projects

Direct import of a directory with media

With the menu item “Add Media Folder and Import Media…”, you can add a directory with media as a new media folder to your project’s recording preferences and import all containing media files directly into your shot library (without copy process). All importable media files, including files in subdirectories, will be imported as new shots.

Important Note: The media folder will be managed by Livegrade so that deleting a shot will also delete the associated media file on your hard drive.


Handling media files

Livegrade provides various options to handle the media files of your recordings and framegrabs:

  • Duplicate As Shot With Still Image: You can duplicate shots with movie recordings as new shots with still images (e.g., to save disk space or to create a duplicate with reference image for working in mobile environments with reduced equipment). The still image is created at the position of the shot’s thumbnail frame and is stored in the currently active record folder, even if the original movie recording is stored in a different media folder.
  • Delete Shots: When deleting shots, you can choose to delete the shot and the associated media file or to delete the shot and keep the media file (e.g., to avoid conflicts with files in a shared media folder).
  • Delete Media of Selected Shots: If you do not need the media files of some shots anymore, you can delete the associated media files of shots and convert your shots with media into “look-only” shots.
  • Reveal Media In Finder:  A “Reveal Media In Finder” item in the contextual menu of the shot library lets you quickly reveal the associated media file of a selected shot in its media folder in the Finder.