ges-launch-1.0 creates a multimedia timeline and plays it back, or renders it to the specified format.
It can load a timeline from an existing project, or create one from the specified commands.
You can inspect action types with:
By default, ges-launch-1.0 is in "playback-mode".
Define a timeline through the command line
ges-launch-1.0 tool allows you to simply build a timeline through a dedicated set of commands:
Adds a clip to the timeline.
See documentation for the --track-types option to ges-launch-1.0, as it will affect the result of this command.
ges-launch-1.0 +clip /path/to/media
This will simply play the sample from its beginning to its end.
ges-launch-1.0 +clip /path/to/media inpoint=4.0
Assuming "media" is a 10 second long media sample, this will play the sample from the 4th second to the 10th, resulting in a 6-seconds long playback.
ges-launch-1.0 +clip /path/to/media inpoint=4.0 duration=2.0 start=4.0
Assuming "media" is an audio video sample longer than 6 seconds, this will play a black frame and silence for 4 seconds, then the sample from its 4th second to its sixth second, resulting in a 6-seconds long playback.
ges-launch-1.0 --track-types=audio +clip /path/to/media
Assuming "media" is an audio video sample, this will only play the audio of the sample in its entirety.
ges-launch-1.0 +clip /path/to/media1 layer=1 set-alpha 0.9 +clip /path/to/media2 layer=0
Assume media1 and media2 both contain audio and video and last for 10 seconds.
This will first add media1 in a new layer of "priority" 1, thus implicitly creating a layer of "priority" 0, the start of the clip will be 0 as no clip had been added in that layer before.
It will then add media2 in the layer of "priority" 0 which was created previously, the start of this new clip will also be 0 as no clip has been added in this layer before.
Both clips will thus overlap on two layers for 10 seconds.
The "alpha" property of the second clip will finally be set to a value of 0.9.
All this will result in a 10 seconds playback, where media2 is barely visible through media1, which is nearly opaque. If alpha was set to 0.5, both clips would be equally visible, and if it was set to 0.0, media1 would be invisible and media2 completely opaque.
Specifies the location of the sample to make a clip from.
Sets the inpoint of the clip, that is the position in the original sample at which the clip will start outputting data.
It is an error to have an inpoint superior to the actual duration of the original sample.
0 by default.
Sets the duration of the clip, that is the duration of the media the clip will output.
It is an error to have inpoint + duration be superior to the duration of the original sample.
The default is the duration of the original sample - the inpoint of the clip.
Sets the start of the clip, that is its position in the timeline.
If not specified, it will be set to the duration of the layer the clip is added on, as the expected default behaviour is to queue clips one after another.
Sets the layer of the clip. The video stream in overlapping clips on different layers will be blended together according to their alpha property, starting with the clip on the last layer. An example is shown in the EXAMPLES section.
If not specified, it will be set to the last layer a clip has been added on, or a first layer if no clip has been added yet.
These have no effects if there is no video stream in the sample.
This is the amount of transparency of the clip, ranging from 0.0 to 1.0 Clips overlapping on different layers will be composited together, unless --disable-mixing has been specified, in the order of the layers.
This is the x position (offset) of the clip in pixels, relatively to the output frame of the timeline.
This is the y position (offset) of the clip in pixels, relatively to the output frame of the timeline.
This is the width in pixels that the clip will occupy in the final output frame.
This is the height in pixels that the clip will occupy in the final output frame.
This is the volume that will be set on the audio part of the clip, ranging from 0.0 to 10.0, with 1.0 being the default.
Set to true to mute the audio of the clip. Default is false.
Specifies the description of a GStreamer a bin, in the gst-launch format.
Properties can be set on the effect either directly in the bin-description, or
separately through the set-
ges-launch-1.0 +clip /path/to/media +effect "agingtv"
This will apply the agingtv effect to "media" and play it back.
Sets the property of an object (for example a clip or an effect). Trying to set a property than can't be looked up is considered an error.
By default, set-
ges-launch-1.0 +clip /path/to/media set-alpha 0.3
This will set the alpha property on "media" then play it back, assuming "media" contains a video stream.
ges-launch-1.0 +clip /path/to/media +effect "agingtv" set-dusts false
This will set the "dusts" property of the agingtv to false and play the timeline back.
Adds a title to the timeline.
The text to be used as a Title.
Load project from file. The project be saved again with the --save option.
-p --sample-path: If some assets are missing when loading a project file, ges-launch-1.0 will try to locate them in this path. It is especially useful when sharing a project.
Identical to --sample-path, but ges-launch-1.0 will also recurse in the subfolders to look for assets.
If set, ges-launch-1.0 will render the specified timeline instead of playing it back. The default rendering format is ogv, containing theora and vorbis.
Set an encoding profile on the command line. See ges-launch-1.0 help profile for more information. This will have no effect if no outputuri has been specified.
Set an encoding profile from a preset file. See ges-launch-1.0 help profile for more information. This will have no effect if no outputuri has been specified.
Specify the track types to be created. When loading a project, only relevant tracks will be added to the timeline.
Set the videosink used for playback.
Set the audiosink used for playback.
Mute playback output. This has no effect when rendering.
Inspect the available action types that can be defined in a scenario set with --set-scenario. Will list all action-types if action-type is empty.
List all valid transition types and exit. See ges-launch-1.0 help transition for more information.
Do not use mixing elements to mix layers together.
Set the number of times to repeat the timeline.
ges-launch-1.0 exposes gst-validate functionalities, such as scenarios. Scenarios describe actions to execute, such as seeks or setting of properties. GES implements editing-specific actions such as adding or removal of clips.
The results of the search are