evrExpanse User Manual v.5.0.0 - updated October 4, 2024

Installation

How to Install evrExpanse

Open the DMG file and drag & drop evrExpanse.app to the Applications folder.

Uninstalling evrExpanse

1. Locate the evrExpanse application in the /Applications folder.
2. Drag the evrExpanse.app file to the Trash bin.
3. Alternatively, you can right-click on the evrExpanse.app file and select "Move to Bin."

Please note that uninstalling evrExpanse will remove the application from your system while retaining the application preferences.

Full Disk Access Permission

To ensure evrExpanse operates seamlessly and to its full potential, please check if Full Disk Access permission is enabled for the application. In specific cases, evrExpanse requires Full Disk Access permission for optimal functionality.

Here's how to grant Full Disk Access:

1. Open System Preferences on your Mac.
2. Navigate to Security & Privacy.
3. Select the Privacy tab.
4. In the left sidebar, click on Full Disk Access.
5. Click the lock icon in the bottom left to make changes and enter your password.
6. Either drag and drop evrExpanse into the list or check the checkbox next to its name.

By granting Full Disk Access, you ensure that evrExpanse can deliver a smooth and uninterrupted experience.

Activating the License

Open the evrExpanse application

Upon clicking the Run button, a pop-up window will appear.

If you have a license key, please enter it along with the email address used for the purchase, then click Activate. Demo licenses also require activation.

If the inserted license key is validated, a message confirming the successful validation will appear.

Deactivating the License

Deactivating a license is an essential step, particularly during an upgrade from a type of license to another one. This process seamlessly reverts evrExpanse to its initial state, prompting users to activate a new license upon startup.

To deactivate the license, follow these simple steps:

1. Open the Preference panel in the application.
2. Locate the "Deactivate License" button.
3. Click on the "Deactivate License" button.
4. A confirmation message will appear, asking if you want to proceed.
5. After confirming your decision, a new message will appear, confirming the successful deactivation of the license.

Deactivating the license will revert it to an unactivated state, removing access to all premium features and benefits of the licensed version.

How to use

After clicking the Run button the main window will pop up.

Export Metadata, Transcode, Offload, and Streamlined Process Plus

evrExpanse offers three primary processes: Export Metadata, Transcode and Offload, which can be utilized independently based on your selection

• Metadata Export: This process allows you to extract metadata from various sources, such as different types of cameras, and import it into your preferred NLEs (Non-Linear Editing Systems) like Final Cut Pro®, DaVinci Resolve®, Assimilate SCRATCH®, Avid Media Composer®, and Pomfort Silverstack®. It streamlines your metadata management, enabling a smoother editing workflow.
• Transcode Master Files: With this process, you can transcode multimedia files into intermediate codecs, including ProRes®, DNxHR®, GoPro CineForm®, HEVC (H.265), DPX®, and OpenEXR®. It supports formats such as MOV, MP4, MXF, MKV and GoPro .360. The transcoded files retain the embedded Master file metadata and Finder Tag, ensuring seamless integration and compatibility within your production pipeline.
• Offload data: Securely transfer and back up your media files. Utilize xxh64 hash format verification for data integrity. Ensure reliable offloading, providing confidence in your backup and streamlined processing.

Additionally, there is an integrated process called Process Plus, which combines Transcode and Export Metadata or Offload and Export Metadata tasks into a single streamlined workflow.

Transcode, Offload, and Metadata Integration

In certain situations, transcoding or offloading Master files may be necessary before importing them into NLEs, while ensuring metadata integration. To achieve this, follow these steps:

1. Begin with Transcoding or Offloading: Start by transcoding or offloading the Master files.
2. Execute the Export Metadata Process: After completing transcoding or offloading, run the Export Metadata process on the processed files. This ensures smooth integration with your NLE software by exporting the necessary metadata.

For this workflow, select the "Process Plus" button to combine transcoding or offloading with metadata export for a seamless, efficient workflow.

Process Plus: Automating the Workflow

Effortlessly merge Transcode or Offload with Export Metadata tasks using Process Plus. This feature lets you process files and extract metadata sequentially. Prior to using Process Plus, ensure you've configured all necessary settings for transcoding/offloading and metadata export to achieve the desired outcome. Keep in mind that the chosen folder for metadata export aligns with the destination folder set in Process settings.

Zero-Byte File Alert

In evrExpanse, the Zero-Byte File Alert serves as a safeguard against potential data integrity issues. This feature alerts users if any zero-byte files are detected before the start of each process. Since zero-byte files can be a sign of file corruption, the alert is a critical tool for ensuring the quality and completeness of your media assets. The Zero-Byte File Alert is available for all processes, including Transcode, Metadata Export, and Offload.

evrExpanse actively tracks and identifies zero-byte files before each process, providing continuous monitoring until the generation of the final report.

By clicking "View Zero-Byte Files," a new TextEdit document will open, displaying the file paths of the detected zero-byte files, allowing for easy review and action.

This meticulous approach guarantees that any potential issues with zero-byte files are thoroughly documented, empowering users to address and rectify them, ensuring a seamless and reliable data management experience. By proactively identifying these files, evrExpanse helps maintain the integrity of your workflow and media assets, minimizing the risk of errors and ensuring smooth processing across all operations.

Metadata Export

Selected Source Folder

To select the folder containing the media files that will be processed in evrExpanse, you can use the convenient drag-and-drop functionality from Finder. Simply locate the desired folder in your Finder window, click and hold the folder, and then drag it over to the designated area within evrExpanse. This streamlines the process of selecting media for metadata export.

Selected Export Format

Select the export format for the metadata file.

The available options are: Final Cut Pro (FCPXML or FCPXMLD), DaVinci Resolve (CSV), Media Composer (ALE), Silverstack (CSV), evrExpanse (CSV), Sony Real Time Metadata (CSV) and Assimilate SCRATCH integration.

Media Composer ALE Settings

Check the default values of Format, FPS or Bin Name. By default, the value of Bin Name is automatically filled with the name of the selected folder, but can be changed.

Assimilate SCRATCH Integration

By selecting the "Insert the selected files with exported metadata into an existing SCRATCH project" option, you can send an XML file directly to the SCRATCH Watch Folder. This XML file contains references to the media files along with their associated metadata. Once the SCRATCH project is loaded, it will automatically process the XML file, incorporating the media files and metadata into the project seamlessly.

Additionally, a copy of the XML file will be saved in a folder within the processed folder. This folder will be named with the prefix **evrE** followed by the name of the processed folder, allowing for easy identification and organization of the XML files linked to the processed media.

Enabling this option streamlines the workflow, ensuring that exported metadata and media files are effortlessly integrated into an existing SCRATCH project, optimizing the process for further editing and finishing in SCRATCH.

Transcode Master File

Selected Source Folder

To select the Source folder containing the media files you want to transcode in evrExpanse, you have the convenient option of using drag and drop functionality from the Finder. Simply locate the desired Source folder in your Finder window, click and hold the folder, then drag it over to the designated area within evrExpanse.

Selected Destination Folder

To select the Destination folder containing the media files transcoded by evrExpanse, you have the convenient option of using drag and drop functionality from the Finder. Simply locate the desired Destination folder in your Finder window, click and hold the folder, then drag it over to the designated area within evrExpanse

Transcoding Mode

Smart

The Smart Mode in evrExpanse performs intelligent transcoding by analyzing the master file's video codec and audio format, deciding whether to transcode or pass-through based on the content.

• Video Stream: If the master video codec is an intermediate or mezzanine codec such as ProRes, DNxHR, or CineForm, Smart Mode will pass through the video stream without re-transcoding, maintaining the original quality. However, if the option "Optimize for Final Cut Pro in Smart Mode" is selected, Smart Mode will only pass through video if the codec is ProRes, ensuring compatibility with Final Cut Pro.
• Audio Stream: If the master audio codec is PCM (16-bit, 24-bit, or 32-bit), the audio stream will be passed through as well. If the codec is not PCM, evrExpanse will transcode the audio to the selected PCM bit depth.

Both audio and video streams are treated independently, meaning that one can be transcoded while the other is passed through. Audio streams are mapped 1:1, ensuring the same number of audio channels in the transcoded file as in the master file.

This mode optimizes the transcoding process by avoiding unnecessary re-transcoding, preserving quality where possible. It ensures maximum efficiency, especially when the "Optimize for Final Cut Pro" option is enabled for ProRes workflows.

Manual

The Manual Mode in evrExpanse is the classic transcoding option, where both audio and video streams are transcoded according to the user-selected settings. This allows for full control over the transcoding process, letting users choose the desired codecs, bitrates, and other settings for their media files. It's ideal for those who need customized output and are not relying on pass-through or automatic bitrate calculations.

Rewrap

The Rewrap transcoding option allows for a 100% quality pass-through of the master audio and video streams, embedding metadata in both the native format and XMP format (supported by Adobe Premiere Pro). In this mode, the output container is set to QuickTime (.MOV), except for MP4 input files, where the container remains MP4 to maintain codec compatibility.

While one of evrExpanse's key features is embedding metadata from the master files into the transcoded copies, there is an option to speed up the process: Include Source Metadata. By unchecking this option, the transcoded file will not retain all the metadata from the master file, allowing for faster processing when full metadata inclusion is not necessary.

Include Source Metadata

The "Include Source Metadata" option lets you decide whether the metadata from the source file will be included in the destination file during the transcoding process.

• When unchecked: The source metadata will not be copied to the destination file, meaning the destination will only include metadata generated during the transcoding process.
• When checked: The metadata from the source file is preserved and embedded in the destination file, in addition to any new metadata generated during transcoding.

This option gives you control over metadata handling during transcoding. Unchecking it can slightly speed up the process, allowing you to customize the integration of metadata based on your needs.

Transcode A/V Settings

Video Codec:

Select the ProRes / HEVC / DNxHR / CineForm / DPX / EXR profiles of your choice. Available profile are those specified in the Apple ProRes white paper and in the Avid DNxHR specification.

• Apple ProRes
  Codec type: hardware accelerated (Apple VideoToolbox)
  Pixel format:
  • YUV 4:2:2 - 10-bit (ProRes 422 Proxy, ProRes 422 LT, ProRes 422, ProRes 422 HQ)
  • YUV 4:4:4:4 - 10-bit (ProRes 4444, ProRes 4444 XQ) with support for alpha channel
• Avid DNxHR
  Codec type: software accelerated (CPU)
  Pixel format:
  • YUV 4:2:2 - 8-bit (DNxHR LB, DNxHR SQ, DNxHR HQ)
  • YUV 4:2:2 - 10-bit (DNxHR HQX), YUV 4:4:4 - 10-bit (DNxHR 444)
• GoPro CineForm:
  Codec type: software accelerated (CPU)
  Pixel format:
  • YUV 4:2:2 - 10-bit (low, medium, high, film1, film2, film3+ )
  • RGB 4:4:4 - 12-bit (RGB 444)
• DPX:
  Codec type: software accelerated (CPU)
  Pixel format:
  • RGB 10/12/16 bit per channel
  • RGBA 8 bit per channel
• EXR:
  Codec type: software accelerated (CPU)
  Compression: Uncompressed/Zip1/RLE
  Pixel format:
  • RGB half/float (16/32 bit)
  • RGBA half/float (16/32 bit)
• HEVC (H.265) [available in Manual mode only]
  Codec type: hardware accelerated (Apple VideoToolbox)
  Pixel format:
  • YUV 4:2:0 8-bit per channel (High, Medium, Low)
  • YUV 4:2:0 10-bit per channel (High, Medium, Low)

HEVC Bitrate

evrExpanse offers two methods for applying bitrate to HEVC transcoding:

1. Automatic with Profiles
2. Custom Bitrate

Custom Bitrate:

This is the most straightforward method, allowing the user to manually enter a custom bitrate in the designated field located in the Transcoding Options section of the main window.

Automatic with Profiles:

This method utilizes an Adaptive Bitrate Calculation Algorithm, which dynamically adjusts the bitrate based on the video resolution and frame rate of each source video in the batch. It compares the input against a reference bitrate of 24,000 Kbps for a 4K UHD (3840x2160) video at 30fps for the High profile. The Medium profile uses 50% of the High bitrate, and the Low profile uses 25%.

While the following table provides standard examples, evrExpanse can handle a wide range of image sizes, frame rates, and aspect ratios, making it adaptable to diverse transcoding needs:

10-bit HEVC Transcoding Support:

evrExpanse supports HEVC transcoding up to 10-bit depth with customizable bit depth management.

If the source video is 10-bit, the Auto option ensures it’s transcoded to HEVC 10-bit, preserving color depth. For 8-bit sources, it’s transcoded to HEVC 8-bit, avoiding unnecessary conversion. These options provide flexibility, ensuring compatibility and efficiency while maintaining optimal video quality.

Audio Codec

The available audio formats in evrExpanse are PCM 16-bit, PCM 24-bit, and PCM 32-bit. When transcoding to image sequences like DPX or EXR, any audio tracks present in the master file will be exported separately as a WAV file, rather than being embedded in the image sequence. The audio tracks can be formatted as mono, stereo, or multichannel, depending on the structure of the original master file’s audio configuration.

This ensures that even in workflows involving DPX or EXR sequences, audio is preserved and correctly formatted for post-production needs.

3D LUT Application and Smart LUT Finder Features

evrExpanse 5 introduces powerful tools for color grading with its 3D LUT Application and Smart LUT Finder features.

Apply 3D LUT allows you to burn a 3D LUT directly into the transcoded file, ensuring consistent color across all outputs. The available options include:

• Use Sidecar LUT: Automatically applies a LUT from the same folder as the media, matching the LUT file to the media based on filenames.
• Custom LUT Folder: Offers flexibility by letting you select a folder of LUT files, which are then automatically matched to the corresponding media files.
• Apply LUT File: Enables the use of a single, user-defined LUT across all media files in a batch, ensuring uniform color grading throughout the project.

Smart LUT Finder Features

The new Smart LUT Finder streamlines color grading by automatically detecting and applying the correct LUT based on video file metadata. Available for Kinefinity cameras and the MCpro24fps app, this feature saves time while ensuring accurate and consistent color.

• Kinefinity: Automatically applies a sidecar LUT file if the name referenced in the source file's metadata is detected.
• McPro24fps: Automatically applies a LUT if it's embedded in the source file’s metadata.
• more cameras will be added soon......

Destination File Name

In this field, you can personalize the name of the transcoded files by adding custom text to the end of the original file name. For example, if the source file name is "A005C039_201101OZ.mov" and you choose to add the text "CamA", the resulting file name will follow one of these formats:

If the "Preserve Source File Name" option is disabled:

[SourceFileName]_evrE_[CodecName_CodecProfile]_YourText.mov

For example:

A005C039-201101OZ_evrE_DNxHR_CamA.mov

If the "Preserve Source File Name" option is enabled:

[SourceFileName]_YourText.mov

For example:

A005C039-201101OZ_CamA.mov

This feature allows you to easily differentiate and identify the transcoded files by adding custom text, providing additional context or information related to your workflow. It gives you flexibility in organizing your files based on your specific requirements or preferences.

Duplicate Source File Name

When source files are located in different folders, it's possible that some files may share the same name. While this might not cause issues in certain workflows, it could create complications in others. Users have the flexibility to choose how to handle duplicate file names—except when the "Preserve Source Folder Structure" option is unchecked. When this option is disabled, all transcoded files will be placed in the same folder, leading to potential overwriting issues.

In cases where duplicate source file names occur and "Preserve Source Folder Structure" is unchecked, evrExpanse automatically renames the transcoded files using the following naming convention:

[SourceFileName]_(checksum_DupRefx)_YourText.mov

Breakdown of the Naming Convention:

• SourceFileName: The original name of the source file.
• checksum: A unique xxh64 hash of the original source file, used to identify whether files with the same name are truly identical or just share the same name.
• X: A reference number (DupRef) that serves as a unique identifier for each transcoding process.
• YourText: An optional custom text that users can append to the file name.

Example:

For a source file named A005C039-201101OZ.mov, the renamed file in the destination folder might look like:

A005C039-201101OZ_(38efdc3d5595ff1d_DupRef3)_CamA.mov

This naming convention ensures that files with the same name but different content are easily distinguished. It also highlights whether files are identical based on their checksums.

Example Scenarios:

Identical Files:

• Clip0001_(38efdc3d5595ff1d_DupRef3)_CamA.mov
• Clip0001_(38efdc3d5595ff1d_DupRef7)_CamA.mov

Different Files with the Same Name:

• Clip0001_(38efdc3d5595ff1d_DupRef3)_CamA.mov
• Clip0001_(3799dc67f0aaeafc_DupRef5)_CamA.mov

This system provides a robust method for handling duplicate file names without risking data loss or overwriting, ensuring each file remains distinct in the destination folder.

Offload

The Offload feature in evrExpanse is optimized for use with Direct Attached Storage (DAS) systems to ensure maximum performance and reliability. While Network Attached Storage (NAS) systems may seem convenient, they often introduce latency and network bottlenecks that can hinder the offload process, leading to slower speeds and potential disruptions. For the best results, we recommend using a DAS solution, which guarantees the high data throughput required for smooth and efficient offloading.

Selected Source Folder

To select the Source folder containing the media files you want to offload, you have the convenient option of using drag and drop functionality from the Finder. Simply locate the desired Source folder in your Finder window, click and hold the folder, then drag it over to the designated area within evrExpanse.

Selected Destination Folder

To select the Destination folder containing the media files transferred by evrExpanse, you have the convenient option of using drag and drop functionality from the Finder. Simply locate the desired Destination folder in your Finder window, click and hold the folder, then drag it over to the designated area within evrExpanse.

After clicking the "Process" button, evrExpanse initiates a streamlined offload workflow. Beginning with source verification and file selection based on specified criteria, the application processes files according to selected options such as ignoring hidden files or including extended attributes. The chosen files are then transferred to the designated destination, with the system logging transfer details, including any encountered errors.

In the Process Completion window, clicking 'Open Offloaded Folder' grants access to the folder containing the transferred files. By selecting 'Transfer Report,' you can review detailed information about the transferred files. Additionally, the 'Event Log' option allows you to review the entire process, providing a comprehensive overview of all events.

Detailed Transfer Report

If the "Save the Transfer Report to the destination" option is enabled, a detailed report is generated alongside the offloaded files, providing a comprehensive record of the transfer process. Users receive a confirmation notification upon completion. The offload process is finalized, ensuring a controlled and documented transfer of files with enhanced data integrity and transparency.

File Integrity Check & Duplication Handling

In cases where a file already exists at the destination, evrExpanse performs a comprehensive checksum comparison, regardless of file size or modification date. This meticulous verification ensures that the source and destination files are 100% identical, providing bulletproof file integrity.

If the checksum of the destination file does not match the source file, evrExpanse duplicates the source file at the destination, appending **2 (evrE copy)** to the end of the file name. It then recalculates and compares the checksums again to verify accuracy. This process guarantees incremental transfer with secure and reliable duplication handling.

Results

During each process, a progress bar will be displayed to track the progress.

If you need to stop the batch process, click the Stop button. When prompted with a warning message, click the End button and wait for the current file to finish processing. It is strongly recommended to let the process shut down properly, which usually takes just a few seconds.

Once a process completes, a completion window will appear, offering options to access the processed files, review the event log, or view a report.

Metadata Export Process

When the Metadata Export process is completed, a folder named evrE_FolderName will be created inside the destination folder. This folder contains the exported metadata in the selected formats, ready for use with corresponding NLEs (Non-Linear Editing systems).

Transcode Process

After the Transcode process is finished, the destination folder will contain the transcoded files. If you selected the option to preserve folder structure, a folder will be created with the name of the source folder, and the transcoded files will be stored inside.

Additionally, a folder named evrE_FolderName will be created in the destination folder, containing the event log for the process. This log provides detailed information about the transcoding process and settings used.

Offload Process

For the Offload process, a folder named FolderName_offload_report will be created alongside the offloaded folder in the destination directory. This folder will include an offload report detailing the transferred files.

Additionally, for all processes, if required, you'll find a folder named ascmhl containing ASC MHL files or a single MHL file inside the offloaded folder for media integrity verification.

Event Log

Additionally, a log file named evrExpanse.log will be saved. While the Event Log aggregates events from all processes initiated by the host machine, the log file located in the processed folder contains events specific to that particular folder. This ensures that you have both an overview of all activities and detailed logs for each individual folder and process.

Preferences

Prior to executing any process within the application, it is highly recommended to take a moment to review the Preferences and either modify or confirm the default settings.

General Preferences

Seal processed folder (MHLs)

Sealing a folder with MHL (Media Hash List) means creating a digital fingerprint of the folder’s contents. This is done by generating cryptographic hashes for each file in the folder. These hashes are then stored in an MHL file.

The MHL file serves as a seal because it provides a snapshot of the folder’s contents at a specific point in time. If any file in the folder is later modified, its hash will change, and it will no longer match the hash stored in the MHL file. This allows you to verify the integrity of the files at any later point, ensuring that they have not been tampered with since the MHL file was created.

evrExpanse provide two types of the Media Hash List (MHL): ASC MHL and the legacy MHL v1.
ASC MHL represents the new standard introduced by the American Society of Cinematographers (ASC) to standardize the media transfer process, aiming to establish uniformity and efficiency in media workflows, while legacy MHL v1 was the initial version developed by Pomfort.

If enabled, the Sealing option will be applied to the selected process: Metadata Export, Transcode, or Offload.

Select MHL type and Hash Format

Within the same window, you have the option to enable or disable the creation of ASC Media Hash lists or MHL v1. Media Hash lists are checksum files that provide a unique fingerprint for each media file based on its content. These hash lists can be used for various purposes, such as verifying the integrity and authenticity of media files during post-production workflows.

By enabling the creation of ASC Media Hash lists or the legacy MHL v1, evrExpanse will generate a separate hash list file for each processed media file. These hash lists can be saved alongside the media files or in a designated folder for easy access and reference.

On the other hand, if you choose to disable the creation of Media Hash lists, evrExpanse will not generate these checksum files during the processing of media files. The option to activate or deactivate Media Hash list creation provides flexibility and control over the generation of these important checksum files. Depending on your specific workflow and requirements, you can choose to include or Media Hash lists as needed.

In terms of hash encoding formats, you can select from various options:

ASC MHL: xxhash (64-bit), the latest xxh3 with 64-bit and 128-bit variants, md5, sha1, sha256, and c4

MHL v1: md5, sha1, xxhash, xxhash64be, xxhash64

Ignore Hidden Files and Folders

When sealing the processed folder (for transcoding or metadata export), an option is available to ignore hidden files or folders.

By default, ASC MHL and MHL v1 operate differently in this regard. ASC MHL ignores macOS system files such as .DS_Store and the "ascmhl" folder containing hash media files, while MHL v1 does not filter any files or folders. In the evrExpanse implementation, the "evrExpanse.log" file generated within the processed folder is added to both versions of the MHLs, and the .DS_Store file is filtered in MHL v1 for consistency. Additionally, there is an option to disregard any hidden files or folders that might exist within the processed folder (the selected folder for exporting metadata and the source folder for transcode master files).

Comparing the behavior differences between ASC MHL and MHL v1 files or folders:

Each time evrExpanse creates an MHL file or seals a folder, it checks for the presence of older MHL files and verifies whether the referenced files exist in the current folder.

Any exceptions encountered will be recorded in the log file named 'evrExpanse.log' as well as in the Event Log session.

In order to commence the Metadata Export process within evrExpanse, it is imperative to ensure the fulfillment of a basic condition: activating either an export format, SCRATCH integration, or sealing the processed folder using your preferred MHL type.

ASC MHL Creator Info

Within the ASC Media Hash List (MHL) settings of evrExpanse, you have the option to define the Creator's Info and choose the desired hash encoding format. The Creator's Info allows you to provide relevant information about the creator or author of the media files. By specifying the ASC MHL Creator's Info and selecting the appropriate hash encoding format, you can customize the ASC MHL configuration according to your specific needs and requirements. This ensures accurate and reliable identification of media files using the chosen hash algorithm, facilitating data integrity verification and preservation during the post-production workflow.

CPU Allocation

The CPU Allocation option in evrExpanse intelligently manages CPU resources across Transcoding, Export Metadata, and Offloading processes. It balances the load on CPU threads to optimize performance based on your system’s capabilities.

CPU Load Profiles:

• Full: Maximizes CPU usage across all threads, optimising tasks like transcoding and metadata export.
• High: Uses 75% of CPU resources, balancing performance and system stability.
• Medium: Uses 50% of CPU resources, reducing heat and preventing throttling.
• Low: Limits CPU usage to 25%, keeping the system responsive, ideal for lower-end systems or multitasking.

When using hardware-accelerated codecs, CPU allocation is less impactful, but still important for non-accelerated tasks. For most users, High or Medium is recommended to prevent overheating and maintain stability during long tasks. Adjusting CPU profiles lets you fine-tune evrExpanse's performance to match your hardware for a smooth workflow.

Export Metadata Preferences

SCRATCH Integration

In the General Settings section of evrExpanse, you have the ability to modify the SCRATCH Watch folder, which is already pre-configured with the default location. This allows you to specify the folder where evrExpanse will send the media files and their associated metadata for automatic processing within SCRATCH.

Additionally, you can customize the SCRATCH project name, group, and timeline settings. It is crucial to provide a valid and existing SCRATCH project name to ensure the successful completion of the upload to SCRATCH. Therefore, it is important to verify and double-check the accurate name of the project within SCRATCH that you intend to send the media files and their metadata to.

Failure to provide the correct project name can result in incomplete or unsuccessful transfer of the media and metadata to SCRATCH.

By customizing these settings in the General Settings section, you can streamline the integration between evrExpanse and SCRATCH, ensuring a seamless and efficient transfer of media files and their associated metadata for further processing and editing within the SCRATCH environment.

Final Cut Pro XML

In the main window, clicking on the "Preferences..." button takes you to the "Metadata Export Settings" section where you can choose the desired Final Cut Pro FCPXML format (FCPXML v1.9, FCPXMLD v1.10, FCPXMLD v1.11 and FCPXMLD v1.12).

Process Transcode Preferences

YUV Format Preservation in Smart Mode

The "Preserve YUV Format" option gives you more control over the transcoding process when using Smart Mode. When enabled, evrExpanse will analyze the input file, and if it detects that the file is already in YUV format, it will bypass the transcoding process and directly copy the video stream to the destination files.

This option helps save time and resources by avoiding unnecessary transcoding of files that are already optimized for your intended output. By selecting this option, you can ensure that the quality and characteristics of the original file are preserved.

Enabling this feature allows evrExpanse to handle YUV format files more efficiently, streamlining the transcoding process for files that don’t require additional processing.

Maintain Final Cut Pro Compatibility in Smart Mode

When the "Optimize for Final Cut Pro in Smart Mode" option is selected, and Smart Mode is enabled, evrExpanse ensures that media files using CineForm or DNx codecs are automatically transcoded to ProRes. This feature is designed specifically for compatibility with Final Cut Pro, which does not support media files using CineForm or DNx codecs.

By enabling this option, only ProRes profiles will be selected as the transcoding codec, guaranteeing that your media files are ready for seamless import and editing in Final Cut Pro. This simplifies the transcoding process, eliminating any codec-related issues and ensuring smooth workflow integration with Final Cut Pro.

Rotate Transcoded Files According to Source Metadata.

When enabled, evrExpanse will automatically rotate transcoded files based on the metadata retrieved from the source, ensuring that the correct orientation is preserved.

The Rotate Transcoded Files (Auto-Rotation) feature is only applicable during transcoding in Manual or Smart mode. If Rewrap mode is selected or if no transcoding occurs in either Manual or Smart mode, the feature will not be applied. This feature relies on the transcoding process to retrieve the necessary metadata and adjust the orientation of the transcoded files accordingly.

Preserve Source File Name in Transcoded File

The "Keep Original File Name" option in evrExpanse allows you to maintain the original source file name for your transcoded files, making it easier to identify and organize your media assets.

When enabled, evrExpanse retains the original file name throughout the transcoding process. For example, if your source file is named "example_video.mp4", the resulting transcoded file will be named "example_video.mov". This consistency helps in easily associating the transcoded file with its corresponding source.

When disabled, evrExpanse will apply the default naming convention:

[SourceFileName]_evrE_[CodecName_CodecProfile].mov

This option is designed to preserve file name consistency. If you require additional customization, you can explore further naming options within evrExpanse's settings.

Maintain Folder Structure

Simplify your transcoding process with the convenient "Maintain Folder Structure" feature, located in the Preferences panel. This option ensures that your transcoded files maintain the same folder organization as your source files. It is particularly useful for projects where retaining the original folder structure is essential for an efficient and straightforward workflow.

This feature in evrExpanse makes it easier to manage and navigate your transcoded files. For users who depend on the original folder structure, this option ensures a consistent and streamlined content creation process, allowing your transcoded files to seamlessly match your existing organization. This makes your creative work more efficient and hassle-free.

HEVC Bit Depth

evrExpanse 5 allows you to customize the bit depth when transcoding to HEVC. You can choose from the following options:

• Auto: Automatically matches the bit depth of the original file.
• 8-bit: Applies an 8-bit depth to all files in the batch.
• 10-bit: Applies a 10-bit depth to all files in the batch.

This flexibility ensures you can tailor the transcoding process to meet the specific needs of your project.

GoPro .360 resolution

Available video resolution are: 4K (4096x2048), 5.6K (5376x2688). This option is designed to select the preferred Equirectangular resolution of the exported 360 video if any raw GoPro .360 video is processed.

everExpanse can also process the GoPro 360 proprietary file format which uses a 360-degree video projection type (Equi-Angular Cubemap projection or EAC) not directly compatible with the type of projection (Equirectangular) supported by streaming platforms or video editing applications. evrExpanse is able to converts these raw .360 files to equirectangular projection video and transcodes them to intermediate codecs embedding the master file EXIF metadata for uploading to YouTube or 360 editors, such as DaVinci Resolve, Adobe Premiere Pro, or Final Cut Pro.

Process Offload Preferences

Ignore hidden files and folders

This feature ensures that hidden files and folders within the source directory are excluded from the offload operation. Hidden files and folders are typically system files or configurations that are not meant for regular user interaction. By choosing to ignore these hidden elements, the offload process focuses on transferring only visible and user-relevant content. This option is particularly useful for streamlining the transfer of essential media files, avoiding unnecessary system-related or hidden data.

Include extended attributes

When you select the "Include Extended Attributes" option during the offload process in macOS, it ensures that Finder tags associated with files are included in the transfer. Finder tags are color-coded labels that users assign to files and folders for organizational purposes. Enabling this option preserves these tags during the offload, allowing for seamless organization and categorization of files at the destination. This is especially useful for maintaining a consistent and organized file structure, ensuring that the visual cues provided by Finder tags are retained.

Save the transfer report to the destination

This feature saves a detailed transfer report at the destination alongside the offloaded files. The transfer report contains comprehensive information about the offload operation, including the names of transferred files, timestamps, and any encountered issues or errors. This ensures a transparent and documented offload process, allowing you to review and verify the success of the transfer.

The Preferences buttons

In the preferences panel there are three buttons (from left to right): Deactivate Licence, Event Log, Default Settings, User Manual and Return to Main Window

Deactivate Licence

See Deactivating the Licence

Event Log

Clicking the "Browse All Past Months Logs" button provides access to the application's comprehensive log file, which captures events from every process executed since the first run on the host machine. The Event Log is saved monthly using the naming convention Event Log YYYY-MM.log.

When you click the "View Current Month Log" button, a window will open, allowing you to view the current month's event log or browse logs from previous months.

The event log tracks all events for each process and is saved on a monthly basis. Additionally, a local log file is generated within the processed folder's report subfolder, providing detailed logs specific to each process.

Reset to Default Settings

The Reset Settings button is located in the Preferences panel of evrExpanse. Clicking this button will reset all application settings to their default values. This can be useful if you encounter issues with the software or simply want to revert to the original configuration. Note that using this feature will erase any custom settings you have configured, so it is recommended to use it with caution. To ensure the reset settings take full effect, it is necessary to reboot your Mac after performing the reset.

User Manual

In order to ensure a smooth user experience, we recognise the significance of comprehensive documentation. To facilitate easy access to information and guidance, we have introduced a User Manual Button in the Preference panel. This convenient addition allows you to explore our detailed User Manual (this) with just a single click.

Return to Main Window

When clicked, it seamlessly guides the user back to the main interface or primary window of evrExpanse, ensuring easy access to essential features and functions. Additionally, this button has an added functionality of automatically saving any selected preferences or settings made by the user. This ensures that your customized preferences are retained and applied when returning to the main window, saving you time and effort.

Media Files and Camera Specifications

evrExpanse supports a wide range of media file types including MOV, MP4, MKV, NEV and MXF formats. Additionally, it is compatible with various camera models from popular manufacturers such as Panasonic, Nikon, Sony Alpha, Fujifilm, Canon, Sony XDCAM*, Z Cam, Kinefinity**, Atomos (Ninja & Inferno), McPRO24fps, GoPro, FiLMIC PRO, Apple iPhone, and ARRI.

While the Export Metadata feature is specifically tailored to the cameras mentioned above, the Transcoding functionality is available for all supported file types, including MOV, MP4, MKV and MXF.

For an up-to-date and comprehensive list of cameras supported by evrExpanse, please refer to our Camera Compatibility Tables.

How to import CSV file in DaVinci Resolve

To import a CSV file containing metadata into DaVinci Resolve, follow these steps:

Open a project in DaVinci Resolve, which should already have clips that you want to populate with imported metadata. Make sure the Media Pool is selected (indicated by a red line).

Choose File > Import Metadata To > Media Pool... to import metadata to potentially every clip in the Media Pool, or choose File > Import Metadata To > Selected Clips... to only import metadata to clips you selected.

When the Import Metadata dialog appears, choose the metadata CSV file generated by evrExpanse, and click Open.

When the Metadata Import dialog appears, by default, DaVinci Resolve tries to use “Match using filename” and “Match using clip start and end Timecode” to match each line of metadata in the CSV file with a clip in the Media Pool, but because "clip start and end Timecode" are not present in imported metadata you have to uncheck “Match using clip start and end Timecode” and (optionally) check “Match using source file paths".

Next, choose which Merge Option you want to use in the Metadata Import dialog.

There are three options:

1. Only update metadata items with entries in the source file (recommended).
   The default setting. Only updates a clip’s metadata if there’s a valid entry in the imported CSV file. Other clip metadata fields are left as they were before the import.
2. Update all metadata fields available in the source file: For each clip that corresponds to a line of metadata in the imported CSV file, every single metadata field referenced by the CSV file is overwritten, regardless of whether or not there’s a valid entry for that field.
3. Update all metadata fields available in the source file and clear others: For each clip that corresponds to a line of metadata in the imported CSV file, every single metadata field referenced by the CSV file is overwritten, regardless of whether or not there’s a valid entry for that field.
   Furthermore, metadata fields that aren’t referenced by the imported CSV file are cleared of

When you’re finished choosing options, click OK and all available metadata from the source CSV file will be imported.

When media files are tagged using the macOS Finder Tag, the associated information will be displayed in the Keyword window and the Flags section within DaVinci Resolve.

This integration allows for seamless transfer of tags from the macOS Finder to DaVinci Resolve, providing easy access to the tagged information. In the Keyword window, you can view and manage the tags applied to the media files, enabling efficient organization and categorization of your assets. Additionally, in the Flags section, you can quickly identify flagged files based on the tags assigned to them.

How to import in Final Cut Pro

Importing media and its metadata into Final Cut Pro with FCPXML is pretty easy and straight forward. Just double-click on the exported file (.FCPXML or .FCPXMLD) and Final Cut Pro will automatically start and ask which library to import the files into.

Alternatively you can import the FCPXML file from the application itself.

When you select media from the browser, you will see the metadata in the information inspector. All metadata will be bundled into a new Metadata View called evrExpanse.

If you open the Metadata Views window by selecting "evrApp Properties" you will be able to add the imported metadata to your liking in any existing metadata view.

Activating evrExpanse 5 Metadata View in Final Cut Pro

If you upgraded from version 3 or 4 to evrExpanse 5, your existing metadata view should automatically migrate to the new format. However, if you check the inspector to view the new metadata list before the first importing with the latest version of evrExpanse, you may notice that after importing the XML file, the metadata doesn't appear for the processed files.

This can also occur when importing metadata for the first time in evrExpanse 5.

Don’t worry—your metadata is still intact. The newly enhanced evrExpanse Metadata View just needs to be activated or refreshed. This only needs to happen once, and once activated, it will inherit the previously imported metadata, automatically converting it to work with Smart Collections and making it searchable in the browser.

1. Open evrExpanse:

• Launch evrExpanse 5 and select the source folder containing your media files.
• Export the metadata by selecting the Final Cut Pro format in evrExpanse.

2. Import Metadata into Final Cut Pro:

• Once the export is complete, open Final Cut Pro.
• Double-click the .FCPXML or .FCPXMLD file generated by evrExpanse to import both the media and metadata into FCP.

3. Access the Metadata View:

• After the media is imported, select a clip in the FCP timeline or browser.
• In the Info Inspector, open the Metadata View dropdown.

4. Activate Metadata View:

• From the Metadata View dropdown, select Edit Metadata View....
• On the left side of the Metadata View window, you'll see a list of available metadata views, including evrExpanse.
• Select evrExpanse and click OK to confirm and activate the view.

Points 1 and 2 are necessary steps to "wake up" the enhanced evrExpanse Metadata View. Without completing these steps in sequence, the new metadata will not be visible in FCP. Once these steps are performed, the enhanced view will be available for all future projects.

Creating a Smart Collection in Final Cut Pro Using evrExpanse Metadata

1. Export FCPXML from evrExpanse 5

Ensure your media files are exported with the relevant metadata embedded in the FCPXML format from evrExpanse 5.

2. Import the FCPXML into Final Cut Pro

Using the Menu:

• Open Final Cut Pro.
• Go to File > Import > XML and select the FCPXML file you exported from evrExpanse.

Using Finder:

• Locate the FCPXML file in Finder and double-click it. This will automatically open it in Final Cut Pro.

3. Check the Metadata

After importing, select a clip to view its metadata in the Inspector. Confirm that the relevant metadata fields are correctly populated.

4. Create a New Smart Collection

• Right-click on the library name in the Libraries sidebar or click New Smart Collection at the bottom.

5. Set Smart Collection Criteria

• Use the dropdown menus to set the initial criteria.
• Select Text > All Text and input the specific text you want to filter by (e.g., a string from the metadata).

6. Add Additional Criteria (Optional)

• To refine your Smart Collection, click the "+" button next to your existing criteria.
• Select Text > All Text again and input any additional text or criteria you want to filter by.

7. Close the Window to Create the Smart Collection

Close the window to save and create the Smart Collection. It will automatically update to include clips that match all the specified criteria.

How to import in Assimilate Scratch

The import of multimedia files and related metadata in Assimilate SCRATCH is even simpler and more direct than in Final Cut Pro. In this case the integration is direct: once the export process is finished, the XML file, generated by evrExpanse, is stored in the SCRATCH Watch folder which will load it as soon as the application is started and the relative project is opened.
Make sure the project name to SCRATCH is set correctly in the evrExpanse settings and you're done! SCRATCH history populated with processed media and corresponding metadata displayed in the right panel.

A copy of the XML file is also saved in the processed files folder (evrE_FolderName) in case the XML file needs to be uploaded to another workstation.

After SCRATCH processes the XML file in the watch folder, it will write a log to the Scratch_insertlogFolderName.log file located inside the processed folder evrE_FolderName

How to import ALE file in Avid Media Composer

After having created the .ale file in evrExpanse, go to the Avid Media Composer and import the clips if not done so far. They should thereon be available as master clips.

Select the bin in the Avid Media Composer which contains the relevant clips.

Select those clips and choose “Input > Import Media…” from the context menu in the bin.

Open the “Options”, then click on “Options…” navigate to the Shot Log tab and select

“Merge events with known master clips”.

Navigate to the ALE file you created before and click “Open”.

Avid Media Composer now matches master clips and metadata information from the .ale file according to their TimeCode, Bin Name and Name of clip.

The information from the .ale file is attached within additional columns in the bin table. Some of the columns are already known by the Avid Media Composer, all unknown information will be added as custom columns.

If you cannot see any custom columns, perform the following steps:

1. Close and re-open the bin
2. Right-click in the free space of the bin window and click on “Choose columns…” in the context menu.
3. Then select and unselect columns, the custom columns from the imported .ale file you will find at the end of the list.

How to import CSV file in Silverstack

After having created the .csv file in evrExpanse, go to the Silverstack Composer and import the clips if not done so far.

To be able to import metadata evrExpanse will use the Drylab CSV import feature in Silverstack.

Select the folder or bin in the library of Silverstack that you want to import metadata for.

Then, in the “Import” menu button in the toolbar select the option Drylab CSV:

When the Finder dialog points you to select a file, choose the CSV file exported from evrExpanse and select “Open”.

There are two options to match the events in the CSV to the clips in the library:

• by Clip Name
• by Creation Date

Select Clip Name and Creation Date (Date only) and click “Continue”.

Import Section: In this step you can select or unselect the metadata that should be imported from the CSV to the Silverstack library.

evrExpanse metadata are under the sections:

• Camera Settings
• Lens and Filter
• Comment and Caption
• Append Tags
• Day Number + Day Date (as Custom 1)

Insert/Update Behavior: Choose if you only want to insert new metadata if a fields is empty or you want to force an overwrite.

Select the option in bold and click "Finish"

If the media files have been tagged using the macOS Finder Tag, the information will be reported in Tags column in Silverstack.

This is the list of metadata (in bold those exportable by evrExpanse) whose fields are mapped in the Silverstack library (sorted by Silvertack metadata section):