Waveform Workflow Operation
ID: waveform
Description
The waveform
operation creates an image showing the temporal audio activity within the recording like this:
The implementation uses an FFmpeg filter that produces a waveform PNG image file from an audio/video file with at least one audio channel.
Parameter Table
configuration | example | description | default |
---|---|---|---|
source-flavors | */audio |
Flavor specifying tracks for which a waveform should be created | n/a |
source-tags | edit |
Tags specifying tracks for which a waveform should be created | n/a |
target-flavor | */waveform |
Flavor used for the generated waveform | n/a |
target-tags | preview |
Comma-separated list of tags to be added to the waveform | n/a |
pixels-per-minute | 400 | Width of waveform image in pixels per minute | 200 |
min-width | 10000 | Minimum width of waveform image in pixels | 5000 |
max-width | 30000 | Maximum width of waveform image in pixels | 20000 |
height | 60 | Height of waveform image in pixels | 500 |
color | black | Color of waveform image, see ffmpeg.org/ffmpeg-all.html#Color | black |
Additional notes:
- All media, that match either source-flavors or source tags will be processed.
- Using a wildcard in the
target-flavor
will cause the main flavor of the input being used.
Operation Example
<operation
id="waveform"
description="Generating waveform">
<configurations>
<configuration key="source-flavor">*/audio</configuration>
<configuration key="target-flavor">*/waveform</configuration>
<configuration key="target-tags">preview</configuration>
<configuration key="pixels-per-minute">200</configuration>
<configuration key="min-width">5000</configuration>
<configuration key="max-width">20000</configuration>
<configuration key="height">60</configuration>
<configuration key="color">black</configuration>
</configurations>
</operation>