Media cues provides playback capabilities, thanks to GStreamer we provide support for a very wide range of media formats, and a variety of effects can be applied at runtime without modification to the source files.
Currently only audio playback is supported
Audio cues allow you to playback audio files.
It’s possible to play the audio of video files
When editing a media cue options, two sections (tabs) are provided,
Media Cue) has a few common options, while the second (
provides fine-grained control on the multimedia source, output and applied effects.
Start time: Start position of the media
Stop time: End position of the media
Loop: Number of repetitions after first play (-1 is infinite)
Start/End time allow you to trim the media file without modifications, keep in mind that the UI will keep showing the original file duration independently of these options.
Loops allow to replay the same media multiple times, they should be seamless if the media content is seamless
and depending on the media format,
.wav are usually a safe option.
Loops can be stopped “artificially” via a
Loop Release action.
Each media cue is made of a sequence of elements, referred as “pipeline”:
Any number of “plugins” or “effects”
In this section both, the pipeline composition and each element options can be controlled.
Active elements can be changed using the Change Pipeline button (bottom left)
The default pipeline composition can be changed via
File > Preferences > Plugins > GStreamer, and will apply on news cues.
While editing multiple media cues at once, it’s necessary to Change Pipeline to select the elements to update.
The pipeline itself cannot be canged in this mode.
Read and decode data from a file, local or remote (e.g. http, https, etc..)
Source: the URI to look for data (a “find file” button is provided for searching local files)
Get the audio from the system-default input device (e.g. microphone), no option is provided
System Input you need to create a media cue with a file, and then change the source element.
Used for audio-processing or data-probing, in some case the order affect the results
Allow to change the volume level, or mute the media.
Volume: volume level in dB (can be muted)
Normalized Volume: parameter used by other components (e.g. ReplayGain) to normalize the volume level without affecting user values, you can only reset the value (to 0dB).
10 Bands Equalizer#
Allow to equalize the media with 10 frequency bands [30Hz-15KHz].
Allow external components to get the current sound level, used for UI visualization.
Time between levels: millisecond between one extracted value and the next (lower values will increase CPU usage)
Peak TTL: Time To Live of decay peak before it falls back (in milliseconds)
Peak falloff: Decay rate of decay peak after TTL (in dB/sec)
Speedup or slowdown the media, without affecting the pitch.
Allow to change the media pitch by semitones.
Provide Dynamic range compression.
Curve shape: Selects how the ratio should be applied
Ratio: Ratio that should be applied
Threshold: minimum value from which the filter is activated (in dB)
Allow to control stereo panorama (left ⟷ right).
When used the audio will be forced to stereo
Allow to manually create a custom GStreamer “elements” using the framework syntax, some instruction and example can be found here.
Send the audio to an output device
Use the system-default output device, no option is provided.
Output to an ALSA device
ALSA device: the output device to be used
Output to the default pulseaudio output device, no option is provided.
Output to a Jack server.
Native JACK is not support in flatpaks, you can get JACK working via PipeWire (pipewire-jack)
The Edit connections button allow to view and change the connection for the cue:
On the left the cue outputs, on the right the available inputs, by selecting one input and one output it’s possible to connect/disconnect using the provided buttons.
Each cue will create a new connection on demand, do not rely on the given names.