Waveform Workflow Operation

ID: waveform

Description

The waveform operation creates an image showing the temporal audio activity within the recording like this:

waveform

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

  - id: waveform
    description: Generating waveform
    configurations:
      - source-flavor: '*/audio'
      - target-flavor: '*/waveform'
      - target-tags: preview
      - pixels-per-minute: 200
      - min-width: 5000
      - max-width: 20000
      - height: 60
      - color: black