Skip to navigation

ExtremRaym

ExtremRaym

Raymond Radet's website

  • Home
  • Return to Content

Navigation

  • Home
  • Blog
    • Categories
      • Creations
      • Articles
      • Reviews
      • Tutorials
      • Resources
      • News
    • Themes
      • Audio
      • Video
      • Web
      • Photo
      • Photomontages
      • Comic-Strips
      • Games
      • Various
  • Services
    • Contact
    • Shop
      • ReaScripts Premium
      • ReaScripts Dev
      • WordPress Plugins
    • Login
  • About
  • Subscribe
Published on: 2018-08-30 Last updated: 2019-05-29

ReaScripts: BWF Metadata pack

  • 1 Introduction
  • 2 Pack Content
  • 3 Screenshots
    • 3.1 Propagate first take BWF metadata to all takes in selected items with bwfmetaedit CLI
    • 3.2 Add BWF metadata to selected media items
    • 3.3 Restore BWF metadata of selected media items from similarly-named XML backup files
    • 3.4 Propagate first half of selected takes BWF metadata to the other half with bwfmetaedit CLI
    • 3.5 Rename selected items based on BWF DESC metadata variables
  • 4 Usage
    • 4.1 BWF MetaEdit Installation
      • 4.1.1 Windows
      • 4.1.2 Mac
    • 4.2 Processing
    • 4.3 User Config Area
  • 5 Known Limitations
    • 5.1 Broken Header
    • 5.2 No Markers/Cue point supports
  • 6 Installation
  • 7 Feature Requests
  • 8 Notes
  • 9 Purchase

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

NameFolderLinksDateVersionChanges
X-Raym_Add BWF metadata to selected media items.luaMetadataScreenshot2020-02-171.6

1.6 (2020-02-17)

  • # append bext and list-info tp wav last chunk

1.5.6 (2020-02-06)

  • # round marker and item pos for comparison

1.5.5 (2020-02-03)

  • # Get marker optimization

1.5.4 (2020-02-03)

  • # ini file save

1.5.3 (2020-01-31)

  • # axml_isrc as global value
  • # remove $markerisrc marker

1.5.2 (2020-01-30)

  • # backup fix

1.5.1 (2020-01-30)

  • + aXML fixes

1.5 (2020-01-30)

  • + Propagate ISRC to aXML (optional)
  • + $markerisrc for marker with ISRC="xxxxxxxxxxxx". It can output to aXML as well.

1.4.3 (2020-01-29)

  • + $regionid wildcard

1.4.2 (2019-10-02)

  • + $notes wildcard

1.4.1 (2019-07-08)

  • + $chans wildcards

1.4 (2019-06-18)

  • # Require REAPER v5.979
  • + No need to add extra quotes for CSV separated value
  • # Change window title
  • + Save last input

1.3 (2019-02-19)

  • # Multiple CLI requests to not have character limits. May be a bit slower but can be use on more items.

1.2.13 (2019-01-30)

  • + Warning popup for commas error

1.2.12 (2018-12-27)

  • + $possample wildcard for item pos timestamp in sample formatted (works with Time metadata)

1.2.11 (2018-09-21)

  • + $parenttrack wildcard

1.2.10 (2018-09-01)

  • # Log break lines
  • # Fix MacOS Multi selection
  • # Backup as user variable

1.2.9 (2018-08-31)

  • # MacOS Fix

1.2.8 (2018-08-31)

  • # Command separator

1.2.7 (2018-08-31)

  • # Correct input

1.2.6 (2018-08-31)

  • # Prevent empty metadata error

1.2.5 (2018-08-31)

  • + $val support

1.2.4 (2018-08-30)

  • # Fix track number

1.2.3 (2018-08-30)

  • # Fix track number

1.2.2 (2018-08-30)

  • # Item and track number fixes

1.2.1 (2018-08-30)

  • # Parsing bug fix

1.2 (2018-07-31)

  • # BWFMetaEdit v.1.3.3 custom rules: no LIST-INFO

1.1 (2018-06-06)

  • # ExecProcess instead of os.execute

1.0 (2018-06-05)

  • + Initial release
X-Raym_Propagate first half of selected takes BWF metadata to the other half with bwfmetaedit CLI.luaMetadataScreenshot2018-08-311.0.1

1.0.1 (2018-08-31)

  • # MacOS fix

1.0 (2018-08-30)

  • + Initial release
X-Raym_Propagate first take BWF metadata to all takes in selected items with bwfmetaedit CLI.luaMetadataScreenshot2019-06-181.4.4

1.4.4 (2019-06-18)

  • # Coding History metadata fix

1.4.3 (2018-08-31)

  • # MacOS fix

1.4.2 (2018-08-30)

  • # Parsing bug fix

1.4.1 (2018-08-30)

  • # Multi item selection bug fix

1.4 (2018-06-06)

  • # ExecProcess instead of os.execute

1.3 (2018-06-05)

  • + All BWF fields

1.2.4 (2018-04-10)

  • # OSX fix

1.2.3 (2018-04-09)

  • # OSX fix

1.2.2 (2018-03-18)

  • # OSX fix

1.2.1 (2018-02-17)

  • # Rename
X-Raym_Rename selected items based on BWF DESC metadata variables.luaMetadataScreenshot2019-02-071.0.5

1.0.5 (2019-02-07)

  • # Revert for SoundDevices mono
  • # iTRK variable for CSV of track channel number and name

1.0.4 (2019-02-07)

  • # Revert TRK#
  • # remove empty tags
  • # Complex TRK# to support poly SoundDevices and mono SoundDevices based on file name

1.0.2 (2019-02-06)

  • # Save variable

1.0.1 (2019-02-06)

  • # TRK# for number of TRK

1.0 (2019-02-06)

  • + Initial release
X-Raym_Restore BWF metadata of selected media items from similarly-named XML backup files.luaMetadata2018-08-311.1.1

1.1.1 (2018-08-31)

  • # MacOS fix

1.1 (2018-06-06)

  • # ExecProcess instead of os.execute

1.0 (2018-06-05)

  • + Initial release

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)
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 parameters which can be customized by the user. Here is the process:

  1. Create a file named exactly like the script file but with .ini extension.
  2. Edit the script from the action list or from a code editor
  3. Copy the USER CONFIG AREA code block at the top of the script to your.ini file
  4. Customize your value

You can also simply copy-rename the script, but you will have to re-do this process at every script update.

Here is an example of file you can create:

-- USER CONFIG AREA --------------------------------------------
-- To modify these values, instead of modding the script, you can simply create a .ini file with same name of the script in the same folder, and copy paste the code below. Then, edit to add you own defaults.

console = true -- true/false: display debug messages in the console
set_back_online = true -- true/false: set peaks offline. Else, wrap this action inside a custom action, between Set items offline / online.
prompt = true -- display the pop up input window

bwf_input = {}
bwf_input.Description = 'n'
bwf_input.Originator = 'n'
bwf_input.OriginatorReference = 'n'
bwf_input.OriginationDate = 'n'
bwf_input.OriginationTime = 'n'
-- bwf_input['TimeReference (translated)'] = 'n'
bwf_input.TimeReference = 'n'
bwf_input.BextVersion = 'n'
bwf_input.UMID = 'n'
bwf_input.LoudnessValue = 'n'
bwf_input.LoudnessRange = 'n'
bwf_input.MaxTruePeakLevel = 'n'
bwf_input.MaxMomentaryLoudness = 'n'
bwf_input.MaxShortTermLoudness = 'n'
bwf_input.CodingHistory = 'n'
bwf_input.IARL = 'n'
bwf_input.IART = 'n'
bwf_input.ICMS = 'n'
bwf_input.ICMT = 'n'
bwf_input.ICOP = 'n'
bwf_input.ICRD = 'n'
bwf_input.IENG = 'n'
bwf_input.IGNR = 'n'
bwf_input.IKEY = 'n'
bwf_input.IMED = 'n'
bwf_input.INAM = 'n'
bwf_input.IPRD = 'n'
bwf_input.ISBJ = 'n'
bwf_input.ISFT = 'n'
bwf_input.ISRC = 'n'
bwf_input.ISRF = 'n'
bwf_input.ITCH = 'n'
---------------------------------------- END OF USER CONFIG AREA

The set_offline here 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

This pack can be installed and auto-updated with the free ReaPack REAPER extension with a custom link related to your licence, or via regular Zip download.
After purchase, detailed installation instructions will be provided here and on the dedicated Purchase Confirmation page.
License are valid lifetime. You will be able to enjoy updates and new scripts added to the pack.

Feature Requests

Miss a function? Let me know!

Notes

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

Cockos Forum Threads:

  • What BWF Metadata related actions do you need ?
  • Scripts: BWF bext and LIST-INFO Metadata (various)

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.

  • Your work for a individual or small business company, you will work on commercial projects, and you want to share the pack to your team.

  • You are a big business company with a team of more than 5 people and this script will be part of your main workflow.

  • You helped developing these scripts. many thanks !

Checkout Added to cart
  • ReaScripts Premium
  • 0 Comments
  • X-Raym
  • bwf, items, metadata, reaper

Languages

  • Français
  • English

Cart

Number of items in cart: 0

  • Your cart is empty.
  • Total: 0.00€
  • Checkout

Product Details

Require:

  • REAPER v5.91
  • BWF MetaEdit CLI v1.3.6
  • Win or MacOS, Linux support on demand (not tested).

Languages:

Support

Customers can have basic support by loging and contacting me via the Contact page.

Contents

  • 1 Introduction
  • 2 Pack Content
  • 3 Screenshots
    • 3.1 Propagate first take BWF metadata to all takes in selected items with bwfmetaedit CLI
    • 3.2 Add BWF metadata to selected media items
    • 3.3 Restore BWF metadata of selected media items from similarly-named XML backup files
    • 3.4 Propagate first half of selected takes BWF metadata to the other half with bwfmetaedit CLI
    • 3.5 Rename selected items based on BWF DESC metadata variables
  • 4 Usage
    • 4.1 BWF MetaEdit Installation
      • 4.1.1 Windows
      • 4.1.2 Mac
    • 4.2 Processing
    • 4.3 User Config Area
  • 5 Known Limitations
    • 5.1 Broken Header
    • 5.2 No Markers/Cue point supports
  • 6 Installation
  • 7 Feature Requests
  • 8 Notes
  • 9 Purchase

Related Posts

  • ReaScripts: REAPER to ProTools with AATranslator Pack
Back to top

Powered by WordPress & Highwind. Customized by X-Raym. Copyright © 2023. Legal Notices.