Published on: Last updated:

ReaScripts: BWF Metadata pack

Introduction

This scripts pack aims to bring some BWF processing and injection features to REAPER, thanks to BWF MetaEdit CLI open source software.

Pack Content

Screenshots

Note: to display items active take source file BWF metadata in REAPER, you can simply use the Item properties: Show media item source properties action.

Propagate first take BWF metadata to all takes in selected items with bwfmetaedit CLI

The render to new take and glue actions are very handy but they erase some valuable metadata infos. This scripts aim to correct that.

A efficient way to re-inject back lost metadata to new rendered items.

Add BWF metadata to selected media items

Add BWF metadata from REAPER. Data can be arbitrary or you can use wildcards. Here is the list:

  • $val (actual value, useful for adding prefix or suffix)
  • $name (item active take name)
  • $itemnumber (on track)
  • $track (item track name)
  • $parenttrack (parent track name of the item track)
  • $tracknumber (track idx)
  • $region (region at item pos)
  • $project (project name)
  • $possample (item pos in sample format for Timecode Reference metadata)
  • $metadata (name of a metadata). You can for eg use $OriginationTime into TimeReference field, which is useful for the Zoom F3 recorder which doesnt seems to print TimeReference metadata into its files. See demo.
Add BWF metadata from REAPER, with wildcards.

Restore BWF metadata of selected media items from similarly-named XML backup files

Previous scripts don’t have CTRL+Z, as the modifications is made directly on files, using another software.

That’s why previous scripts automatically dump a backup of the metadata in a XML file next to their source. This script will re-inject the backup into their original source.

Add data, and restore from backup.

Propagate first half of selected takes BWF metadata to the other half with bwfmetaedit CLI

Useful if you use the Render -> Selected items and you want to preserve original items BWF. Just use the Import rendered items to new tracks setting and run the script.

Rename selected items based on BWF DESC metadata variables

This uses BWF desc variables as found in SoundDevise or Aaton Digital created files.

Avaibles wildcards are:

$NOTE $SCENE $SPEED $TAG $TAKE $TAPE $TRK $TRK# $iTRK $TYPE $UBITS

Some of these infos are redundant with iXML ones so this can be very handy.

You can also rename the track the item is on with SWS: Set track name from first selected item on track action. This will allow you to name a track based on a Tape name for eg.

Usage

BWF MetaEdit Installation

To Get and Set BWF metadata, these scripts use the great free and open source BWF MetaEdit software. You will need to download and install the CLI version to make them work.

CLI, for Command Line Interface, is a way to call a software without interface. In this case, it make it allows software to communicate between each others.

Version 1.3.6 or higher is required, cause I personally contributed to bug hunting and bug fixes of prior versions.

Windows

  1. Go to BWF MetaEdit Windows Download
  2. Download the CLI version according to your OS version (32bits, or 64 bits)
  3. Put the bwfmetaedit.exe file in the UserPlugins subfolder of your REAPER Resource directory (Options → Show REAPER resource path in explorer)

Mac

  1. Go to BWF MetaEdit MacOS Download
  2. Download the CLI version according to your OS version (32bits, or 64 bits)
  3. Put the bwfmetaedit file in the UserPlugins subfolder of your REAPER Resource directory (Options → Show REAPER resource path in explorer)

Processing

To process item source, all items with same source have to be set as Offline. Though, setting back to Online can take a bit of time if you have a lot of TakeFX.

Also, be sure to have write access to the chosen files. It shouldn’t be open by other software, or even in REAPER Media Explorer.

User Config Area

These files contains User Config Area variables for which the values can be customized by the user. Check preset script file creation to see how it works.

    The set_offline variable is particularly useful, if you want to chain this action with others actions which needs to process on offline items. It allows to save a lot of performance if you have a lot of items with take FX, as setting offline/online takes time. Here is an example of custom action:

    Custom: Rename source and add BWF:

    1. Script: X-Raym_Rename selected takes source file name according to take name in the limit of 32 characters and with 001 counter.lua
    2. Script: X-Raym_Propagate first take BWF Description to all takes in selected items with bwfmetaedit CLI.lua

    (The set items back online stage is handle here by the second script).

    Known Limitations

    Broken Header

    BWF MetaEdit is very strict about metadata. If your file contains invalid file size metadata, as it seems to happen with some audio metadata/library softwares, BWFMetaEdit will not be able to process them. You can help sponsoring the dev of a fix header size feature right in BWF MetaEdit by making a donation to the project maintainers and sending them message about this particular issue.

    No Markers/Cue point supports

    For the moment, the script doesn’t support markers. This may be added in the future.

    Installation

    After purchase, just log into the website, to check the detailed installation instructions here, or on the dedicated Purchase Confirmation page. This pack can be installed and updated from REAPER thanks to the free ReaPack extension, via a custom repository link related to your licence, or via regular Zip download. License are valid lifetime. You will be able to enjoy updates and new scripts added to the pack without extra cost.

    Feature Requests

    Miss a function? Let me know!

    Notes

    By buying this product, you are supporting my free scripting. Thanks!

    Cockos Forum Threads:

    Thanks to BWF MetaEdit team for providing their software free and open source. I invite you to make a donation to the project maintainers!

    And thanks cfillion from Reapack for the help on the CLI commands! 😛

    Purchase

    • Personnal use, you are an individual, a student, or a non-profit organization, and you will not use this pack on commercial projects.

    • You work for a small business company on commercial projects.

    • You are a big business company with a team of more than 5 people. Consider one purchase per team.

    • You helped developing these scripts. Many thanks !