Provided by: openshot-qt_2.6.1+dfsg1-4_all 
NAME
openshot-qt - OpenShot Video Editor Documentation
OpenShot Video Editor is an award-winning, open-source video editor, available on Linux,
Mac, and Windows. OpenShot can create stunning videos, films, and animations with an
easy-to-use interface and rich set of features.
Learning to use OpenShot is easy, and with this guide, you will be a master in no time at
all!
TABLE OF CONTENTS:
Introduction
OpenShot Video Editor is an award-winning, open-source video editor, available on Linux,
Mac, and Windows. OpenShot can create stunning videos, films, and animations with an
easy-to-use interface and rich feature-set.
Features
• Cross-platform (Supports Linux, OS X, and Windows)
• Support for many video, audio, and image formats (based on FFmpeg)
• Powerful curve-based Key frame animations
• Desktop integration (drag and drop support)
• Unlimited tracks / layers
• Clip resizing, scaling, trimming, snapping, rotation, and cutting
• Video transitions with real-time previews
• Compositing, image overlays, watermarks
• Title templates, title creation, sub-titles
• 2D animation support (image sequences)
• 3D animated titles (and effects)
• SVG friendly, to create and include vector titles and credits
• Scrolling motion picture credits
• Advanced Timeline (including Drag & drop, scrolling, panning, zooming, and snapping)
• Frame accuracy (step through each frame of video)
• Time-mapping and speed changes on clips (slow/fast, forward/backward, etc…)
• Audio mixing and editing
• Digital video effects, including brightness, gamma, hue, greyscale, chroma key
(bluescreen / greenscreen) , and many more!
Screenshot
[image]
System Requirements
Video editing benefits from large amounts of memory, modern CPUs, and fast disks.
Basically, you want the best computer you can afford when editing video. Here are the
minimum system requirements:
• 64-bit Operating System (Linux, OS X, Windows 7/8/10)
• Multi-core processor with 64-bit support
• 4GB of RAM (16GB recommended)
• 500 MB of hard-disk space for installation
• Optional: Solid-state drive (SSD), if utilizing disk-caching (and an additional 10GB of
hard-disk space)
License
OpenShot Video Editor is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.
Installation
The latest and greatest version of OpenShot Video Editor for Linux, Mac, and Windows can
be downloaded fromm the official download page at https://www.openshot.org/download/.
Linux
Most Linux distributions have a version of OpenShot in their software repositories, so
installation should be easy. Some might have an outdated version though (make sure to
check the version number). The easiest way to ensure you have the very latest version, is
to download an AppImage from the project website. Once downloaded, right click on the
AppImage file, choose Properties, and mark the file as Executable. Now, go ahead and
double click the AppImage to launch it.
Mac
Download the DMG file from the project website, double click it, and then drag the
OpenShot application icon into your Applications shortcut. This is very similar to how
most other Mac applications are installed. Now launch OpenShot from Launchpad.
Windows
Download the Windows installer executable from the project website, double click it, and
follow the directions on screen. Once completed, OpenShot will be installed and available
in your Start menu.
Quick Tutorial
Using OpenShot is very easy, and this tutorial will take you through the basics in under 5
minutes. After this tutorial, you will be able to make a simple photo slide-show with
music.
Step 1 – Import media files
Before we can begin making a video, we need to import media files into OpenShot. Most
video, image and music file formats will work. Drag and drop a few videos or images and a
music file from your Desktop to OpenShot. Be sure to drop the files where the arrow in the
illustration is pointing to. [image]
Alternative methods to add files to your projects are described in the section Import
Files. The “Show All”, “Video”, “Audio”, “Image” filters above the added files allows you
to only see the file types you are interested in.
Step 2 – Arrange Videos and Photos on Timeline
Next, drag each video or photo onto a track in the timeline (as seen in the illustration).
The timeline represents your final video, so arrange your photos in whatever sequence you
want them to appear in your video. If you overlap two clips, OpenShot will automatically
create a smooth fade between them, displayed by blue rounded rectangles between the clips.
Remember, you can rearrange the clips as many times as needed by simply dragging and
dropping them. [image]
Step 3 – Add Music to Timeline
To make our creation more interesting, we need to add some music. Click on the music file
that you imported in step 1, and drag it onto the timeline. If the song is too long, grab
the right edge of your music clip, and resize it smaller (that will make it end earlier).
You could also insert the same file multiple times, if your music is too short. [image]
Step 4 – Preview your Project
To preview what our video looks & sounds like, click the Play button under the preview
window. You can also pause, rewind, and fast-forward your video project by clicking the
corresponding buttons. [image]
Step 5 – Export your Video
Once you are happy with your project, the next step is to export your video. This will
convert your OpenShot project into a single video file, which will work on most media
players (such as VLC) or websites (such as YouTube, Vimeo, etc…).
Click on the Export Video icon at the top of the screen (or use the File > Export Video
menu). Choose from one of the many preset export options, and click the Export Video
button. [image]
You should now have a basic understanding of how OpenShot works. Importing, Arranging,
Previewing, and Exporting. Hopefully this tutorial took less than 5 minutes for you to
complete. Please read the rest of this guide for a more detailed understanding of
OpenShot, and it’s advanced features. Enjoy!
Main Window
OpenShot Video Editor has one main window which contains most of the information, buttons,
and menus needed to edit your video project.
Overview
[image]
┌──┬───────────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼───────────────────┼──────────────────────────┤
│1 │ Main Toolbar │ Contains buttons to │
│ │ │ open, save, and export │
│ │ │ your video project. │
├──┼───────────────────┼──────────────────────────┤
│2 │ Function Tabs │ Switch between Project │
│ │ │ Files, Transitions, and │
│ │ │ Effects. │
├──┼───────────────────┼──────────────────────────┤
│3 │ Project Files │ All audio, video, and │
│ │ │ image files that have │
│ │ │ been imported into your │
│ │ │ project. │
├──┼───────────────────┼──────────────────────────┤
│4 │ Preview Window │ This is the area that │
│ │ │ the video will playback │
│ │ │ on the screen. │
├──┼───────────────────┼──────────────────────────┤
│5 │ Edit Toolbar │ This toolbar contains │
│ │ │ buttons used for │
│ │ │ snapping, inserting │
│ │ │ markers, and jumping │
│ │ │ between markers. │
├──┼───────────────────┼──────────────────────────┤
│6 │ Zoom Slider │ This slider will adjust │
│ │ │ the time-scale of your │
│ │ │ timeline. │
├──┼───────────────────┼──────────────────────────┤
│7 │ Play-head / Ruler │ The ruler shows the │
│ │ │ time-scale, and the red │
│ │ │ line is the play-head. │
│ │ │ The play-head represents │
│ │ │ the current playback │
│ │ │ position. │
└──┴───────────────────┴──────────────────────────┘
│8 │ Timeline │ The timeline visualizes │
│ │ │ your video project, and │
│ │ │ each clip and transition │
│ │ │ in your project. │
├──┼───────────────────┼──────────────────────────┤
│9 │ Filter │ Filter the list of items │
│ │ │ shown (project files, │
│ │ │ transitions, and │
│ │ │ effects) by using these │
│ │ │ buttons and filter │
│ │ │ textbox. Enter a few │
│ │ │ letters of what you are │
│ │ │ looking for, and the │
│ │ │ results will be shown. │
└──┴───────────────────┴──────────────────────────┘
For step-by-step instructions on the basic usage of OpenShot, be sure to read the Quick
Tutorial.
Built-in Tutorial
When you first launch OpenShot, you will be presented with a friendly built-in tutorial.
It will point out and explain the basics. Clicking Next will jump to the next topic. You
can always view this tutorial again from the Help→Tutorial menu. [image]
Tracks & Layers
OpenShot uses tracks to layer videos and images. The top most track is the top layer, and
the bottom track is the bottom layer. If you are familiar with layers in a photo editing
application, then you should be quite familiar with this concept. OpenShot will mix each
layer together, just like a photo editing application. You can have an unlimited number of
tracks, but typically a video project will not need more than 10 (or so) tracks.
For example, imagine a 3 track video project [image]
┌──┬──────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼──────────────┼──────────────────────────┤
│1 │ Top Track │ Clips on this track will │
│ │ │ always be on top and │
│ │ │ visible │
├──┼──────────────┼──────────────────────────┤
│2 │ Middle Track │ Clips in the middle │
│ │ │ (might or might not be │
│ │ │ visible, depending on │
│ │ │ what is above them) │
├──┼──────────────┼──────────────────────────┤
│3 │ Bottom Track │ Clips on this track will │
│ │ │ always be on the bottom │
└──┴──────────────┴──────────────────────────┘
Keyboard Shortcuts
Here is a list of the default keyboard shortcuts supported by OpenShot. You can configure
these shortcuts in the Preferences dialog. Learning a few of these shortcuts can save you
a bunch of time!
┌───────────────────┬────────────────────────────┐
│Shortcut │ Action │
├───────────────────┼────────────────────────────┤
│Ctrl+H │ About OpenShot │
├───────────────────┼────────────────────────────┤
│Ctrl+M │ Add Marker │
├───────────────────┼────────────────────────────┤
│Ctrl+Shift+T │ Add Track │
├───────────────────┼────────────────────────────┤
│Ctrl+W │ Add to Timeline │
└───────────────────┴────────────────────────────┘
│Ctrl+B │ Animated Title │
├───────────────────┼────────────────────────────┤
│Ctrl+P │ Choose Profile │
├───────────────────┼────────────────────────────┤
│Ctrl+C │ Copy │
├───────────────────┼────────────────────────────┤
│Delete │ Delete Item │
├───────────────────┼────────────────────────────┤
│Backspace │ Delete Item │
├───────────────────┼────────────────────────────┤
│Ctrl+D │ Details View │
├───────────────────┼────────────────────────────┤
│Ctrl+E │ Export Video │
├───────────────────┼────────────────────────────┤
│L │ Fast Forward │
├───────────────────┼────────────────────────────┤
│F11 │ Fullscreen │
├───────────────────┼────────────────────────────┤
│Ctrl+F │ Import Files │
├───────────────────┼────────────────────────────┤
│Ctrl+End │ Jump to End │
├───────────────────┼────────────────────────────┤
│Ctrl+Home │ Jump to Start │
├───────────────────┼────────────────────────────┤
│Ctrl+N │ New Project │
├───────────────────┼────────────────────────────┤
│Right │ Next Frame │
├───────────────────┼────────────────────────────┤
│Ctrl+Right │ Next Marker │
├───────────────────┼────────────────────────────┤
│Ctrl+O │ Open Project │
├───────────────────┼────────────────────────────┤
│Ctrl+V │ Paste │
├───────────────────┼────────────────────────────┤
│Space │ Play/Pause Toggle │
├───────────────────┼────────────────────────────┤
│Up │ Play/Pause Toggle │
├───────────────────┼────────────────────────────┤
│Down │ Play/Pause Toggle │
├───────────────────┼────────────────────────────┤
│K │ Play/Pause Toggle │
├───────────────────┼────────────────────────────┤
│Ctrl+Shift+P │ Preferences │
├───────────────────┼────────────────────────────┤
│Left │ Previous Frame │
├───────────────────┼────────────────────────────┤
│Ctrl+Left │ Previous Marker │
├───────────────────┼────────────────────────────┤
│Ctrl+I │ Properties │
├───────────────────┼────────────────────────────┤
│Ctrl+Q │ Quit │
├───────────────────┼────────────────────────────┤
│Ctrl+Y │ Redo │
├───────────────────┼────────────────────────────┤
│J │ Rewind │
├───────────────────┼────────────────────────────┤
│Ctrl+S │ Save Project │
├───────────────────┼────────────────────────────┤
│Ctrl+Shift+S │ Save Project As… │
├───────────────────┼────────────────────────────┤
│Ctrl+A │ Select All │
├───────────────────┼────────────────────────────┤
│Ctrl+Shift+A │ Select None │
└───────────────────┴────────────────────────────┘
│Ctrl+K │ Slice All: Keep Both Sides │
├───────────────────┼────────────────────────────┤
│Ctrl+L │ Slice All: Keep Left Side │
├───────────────────┼────────────────────────────┤
│Ctrl+J │ Slice All: Keep Right Side │
├───────────────────┼────────────────────────────┤
│Ctrl+G │ Toggle Snapping │
├───────────────────┼────────────────────────────┤
│R │ Toggle Razor tool │
├───────────────────┼────────────────────────────┤
│Ctrl+X │ Split Clip │
├───────────────────┼────────────────────────────┤
│Ctrl+Shift+D │ Thumbnail View │
├───────────────────┼────────────────────────────┤
│Ctrl+T │ Title Editor │
├───────────────────┼────────────────────────────┤
│Ctrl+Z │ Undo │
├───────────────────┼────────────────────────────┤
│= │ Zoom In │
├───────────────────┼────────────────────────────┤
│– │ Zoom Out │
├───────────────────┼────────────────────────────┤
│Ctrl+Scroll │ Zoom In/Out │
├───────────────────┼────────────────────────────┤
│Ctrl+Middle Button │ Scroll Timeline │
└───────────────────┴────────────────────────────┘
Files
To create a video, we need to make media files available to our project by importing files
into OpenShot. Most media file types are recognized, such as videos, images, and audio
files. Files can be viewed and managed in the Project Files panel.
Note that imported files are not copied anywhere, they remain in the physical location
they were before and are simply being made available to your video project. So, they must
not be deleted or moved after adding them to your project. The “Show All”, “Video”,
“Audio”, “Image” filters above the files allows you to only see the file types you are
interested in. You can also toggle the view between details and thumbnails view of your
files.
Import Files
These are all possible methods to import media files into OpenShot: [image]
File Menu
To view the file menu, right click on a file (in the Project Files panel). Here are the
actions you can use from the file menu. [image]
┌────────────────────┬──────────────────────────────────┐
│Name │ Description │
├────────────────────┼──────────────────────────────────┤
│Import Files… │ Import files into your project │
├────────────────────┼──────────────────────────────────┤
│Thumbnail/Detail │ Toggle the view between details │
│ │ and thumbnails │
├────────────────────┼──────────────────────────────────┤
│Preview File │ Preview a media file │
├────────────────────┼──────────────────────────────────┤
│Split Clip… │ Split a file into many smaller │
│ │ clips │
├────────────────────┼──────────────────────────────────┤
│Edit Title │ Edit an existing title SVG file │
├────────────────────┼──────────────────────────────────┤
│Duplicate Title │ Make a copy, and then edit the │
│ │ copied title SVG file │
└────────────────────┴──────────────────────────────────┘
│Add to Timeline │ Add many files to the timeline │
│ │ in one step │
├────────────────────┼──────────────────────────────────┤
│File Properties │ View the properties of a file, │
│ │ such as frame rate, size, etc… │
├────────────────────┼──────────────────────────────────┤
│Remove from Project │ Remove a file from the project │
└────────────────────┴──────────────────────────────────┘
Split Clip
If you need to cut a file into many smaller clips before editing, the Split Clip dialog is
built exactly for this purpose. Right click on a file, and choose Split Clip… from the
file menu. This opens the Split Clip dialog. Use this dialog to quickly cut out as many
small clips as you need. The dialog stays open after you create a clip, to allow you to
repeat the steps for your next clip. When you are finished, simply close the dialog.
[image]
Please refer to the section Cutting & Slicing for more ways to cut and slice clips
directly in the timeline.
Add to Timeline
In certain cases, you might need to add many files to the timeline at the same time. For
example, a photo slide show, or a large number of short video clips. The Add to Timeline
dialog can automate this task for you. First, select all files you need to add, right
click, and choose Add to Timeline. [image]
Properties
To view the properties of any imported file in your video project, right click on the
file, and choose File Properties. This will launch the file properties dialog, which
displays information about your media file. For certain types of images (i.e. image
sequences), you can adjust the frame rate on this dialog also. [image]
Remove from Project
This will remove a file from the project. It will not delete the underlying physical file
though, so removing a file from the project merely makes it unavailable for this video
project.
Clips
Each media file you add to the OpenShot timeline is called a clip, and is visualized by a
dark, rounded rectangle (as seen in the screenshot below). A clip has a large number of
properties, which affects how the clip is rendered and composited, such as scale,
location, rotation, and alpha. These properties can also be animated over time, and when
combined together, can create some amazing effects.
Overview
[image]
┌──┬────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼────────────┼──────────────────────────┤
│1 │ Clip 1 │ A video clip │
├──┼────────────┼──────────────────────────┤
│2 │ Transition │ A gradual fade │
│ │ │ transition between the 2 │
│ │ │ clips │
├──┼────────────┼──────────────────────────┤
│3 │ Clip 2 │ An image clip │
└──┴────────────┴──────────────────────────┘
Cutting & Slicing
OpenShot has many easy ways to adjust the start and end positions of a clip (otherwise
known as cutting). The most common method is simply grabbing the left (or right) edge of
the clip and dragging. Here is a list of methods for cutting clips in OpenShot:
Keep in mind that the above cutting methods also have Keyboard Shortcuts, to save even
more time.
Preset Menu
OpenShot has tons of great preset animations and clip properties, such as fading, sliding,
zooming, etc… These presets can be accessed by right clicking on a clip. [image]
Transform
To quickly adjust the location and scale of a clip, select a clip on the timeline, right
click and choose Transform. Grab any of the small blue handles to adjust scale, and grab
the middle circle to move the image. Note: Pay close attention to where the play-head
(i.e. red playback line) is. Key frames are automatically created at the current playback
position, to help create animations. [image]
For more info on key frames and animation, see Animation.
Effects
In addition to the many clip properties which can be animated and adjusted, you can also
drop an effect directly onto a clip. Each effect is represented by a small letter icon.
Clicking the effect icon will populate the properties of that effect, and allow you to
edit (and animate) them. [image]
Properties
Below is a list of clip properties which can be edited, and in most cases, animated over
time. To view a clip’s properties, right click and choose Properties. The property editor
will appear, where you can change these properties. Note: Pay close attention to where the
play-head (i.e. red playback line) is. Key frames are automatically created at the current
playback position, to help create animations.
For more info on key frames and animation, see Animation.
Transitions
A transition is used to gradually fade (or wipe) between two clips. In OpenShot,
transitions are represented by blue, rounded rectangles on the timeline. They are
automatically created when you overlap two clips, and can be added manually by dragging
one onto the timeline from the Transitions panel. A transition must be placed on top of a
clip (overlapping it), with the most common location being the beginning or end.
Overview
[image]
┌──┬────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼────────────┼──────────────────────────┤
│1 │ Clip 1 │ A video clip │
├──┼────────────┼──────────────────────────┤
│2 │ Transition │ A gradual fade │
│ │ │ transition between the 2 │
│ │ │ clips, created │
│ │ │ automatically by │
│ │ │ overlapping the clips. │
├──┼────────────┼──────────────────────────┤
│3 │ Clip 2 │ An image clip │
└──┴────────────┴──────────────────────────┘
Direction
Transitions adjust the alpha/transparency of the clip below it, and can either fade from
opaque to transparent, or transparent to opaque. Right click and choose Reverse Transition
to change the direction of the fade. You can also manually adjust the Brightness curve,
animating the fade in any way you wish. [image]
Cutting & Slicing
OpenShot has many easy ways to adjust the start and end positions of a transition
(otherwise known as cutting). The most common method is simply grabbing the left (or
right) edge of the transition and dragging. Here is a list of methods for cutting
transitions in OpenShot:
Keep in mind that all of the above cutting methods also have Keyboard Shortcuts.
Mask
Like Clips, transitions also have properties which can be animated over time. The fade (or
wipe) can be adjusted with the Brightness curve, or held at a constant value to create a
transparency mask on top of a clip.
Custom Transition
Any greyscale image can be used as a transition (or mask), by adding it to your
/.openshot_qt/transitions/ folder. Just be sure to name your file something that is easily
recognizable, and restart OpenShot. Your custom transition/mask will now show up in the
list of transitions.
Properties
Below is a list of transition properties which can be edited, and in most cases, animated
over time. To view a transition’s properties, right click and choose Properties. The
property editor will appear, where you can change these properties. NOTE: Pay close
attention to where the play-head (i.e. red playback line) is. Key frames are automatically
created at the current playback position, to help create animations.
Animation
OpenShot has been designed specifically with animation in mind. The powerful curve-based
animation framework can handle most jobs with ease, and is flexible enough to create just
about any animation. Key frames specify values at certain points on a clip, and OpenShot
does the hard work of interpolating the in-between values.
Overview
[image]
Key Frames
To create a key frame in OpenShot, simply position the play-head (i.e. playback position)
at any point over a clip, and edit properties in the property dialog. If the property
supports key frames, it will turn green, and a small green tick mark will appear on your
clip at that position. Move your play-head to another point over that clip, and adjust the
properties again. All animations require at least 2 key frames, but can support an
unlimited number of them.
To adjust the interpolation mode, right click on the small graph icon next to a property
value.
For more info on clip properties, see Properties. For more info on preset animations, see
Preset Menu. For more info on creating key frames for location and scale, see Transform.
Bézier Presets
When using a Bézier curve for animation, OpenShot includes more than 20 curve presets
(which affect the shape of the curve). For example, Ease-In has a more gradual slope at
the beginning, making an animation move slower at the beginning, and faster at the end.
Ease-In/Out (Back) has a gradual beginning and ending, but actually goes past the expected
value and then back (producing a bounce effect).
To choose a curve preset, right click on the small graph icon next to a key frame.
[image]
Image Sequences
If you have a sequence of similarly named images (such as, cat001.png, cat002.png,
cat003.png, etc…), you can simply drag and drop one of them into OpenShot, and you will be
prompted to import the entire sequence.
To adjust the frame rate of the animation, right click and choose File Properties in the
Project Files panel, and adjust the frame rate. Once you have set the correct frame rate,
drag the animation onto the timeline. [image]
Titles
Adding text and titles is an important aspect of video editing, and OpenShot comes with an
easy to use Title Editor. Use the Title menu (located in the main menu of OpenShot) to
launch the Title Editor. You can also use the keyboard shortcut Ctrl+T.
Overview
[image]
Custom Titles
OpenShot can use any vector SVG image file as a title template. Just add an SVG image file
to your .openshot_qt/title_templates/ folder, and it will appear the next time you open
the Title Editor interface. You can also right click on any SVG files in your Project
Files panel, and choose Edit Title or Duplicate Title.
3D Animated Titles
Adding a 3D animated title is just as easy, using our Animated Title dialog. Use the Title
menu (located in the main menu of OpenShot) to launch the Animated Title editor. You can
also use the keyboard shortcut Ctrl+B. [image]
┌──┬───────────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼───────────────────┼──────────────────────────┤
│1 │ Choose a Template │ Choose from any │
│ │ │ available 3D title │
│ │ │ templates │
├──┼───────────────────┼──────────────────────────┤
│2 │ Preview Title │ Preview your title as │
│ │ │ you make changes │
├──┼───────────────────┼──────────────────────────┤
│3 │ Title Properties │ Change the text, colors, │
│ │ │ and advanced properties │
├──┼───────────────────┼──────────────────────────┤
│4 │ Render │ Render the 3D animation, │
│ │ │ and add it to your │
│ │ │ project │
└──┴───────────────────┴──────────────────────────┘
This feature requires the latest version of Blender (https://www.blender.org/download/) be
installed, and the OpenShot Preferences updated with the correct path to the Blender
executable (for example: /home/USER/blender-2.78/blender).
Profiles
A profile is a collection of common video settings (size, frame rate, aspect ratio, etc…).
Profiles are used during editing, previewing, and exporting to provide a quick way to
switch between common combinations of these settings.
Project Profile
The project profile is used when previewing your project and editing. The default project
profile is “HD 720p 24fps”. It is best practice to always switch to your target profile
before you begin editing. For example, if you are targeting 1080p 30fps, switch to that
profile before you begin editing your project. [image]
┌──┬────────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼────────────────┼──────────────────────────┤
│1 │ Title Bar │ The title bar of │
│ │ │ OpenShot displays the │
│ │ │ current profile │
├──┼────────────────┼──────────────────────────┤
│2 │ Profile Button │ Launch the profiles │
│ │ │ dialog │
├──┼────────────────┼──────────────────────────┤
│3 │ Choose Profile │ Select a profile for │
│ │ │ editing and preview │
└──┴────────────────┴──────────────────────────┘
Export Profile
The export profile always defaults to your current project profile, but can be changed to
target different profiles. [image]
┌──┬────────────────┬──────────────────────────┐
│# │ Name │ Description │
├──┼────────────────┼──────────────────────────┤
│1 │ Choose Profile │ Select a profile for │
│ │ │ export │
└──┴────────────────┴──────────────────────────┘
Custom Profile
Although OpenShot has more than 70 profiles included by default, you can also create your
own custom profiles. Create a new file in the /.openshot_qt/profiles/ folder. Use the
following text as your template (i.e. copy and paste this into the file):
description=Custom Profile Name
frame_rate_num=30000
frame_rate_den=1001
width=1280
height=720
progressive=1
sample_aspect_num=1
sample_aspect_den=1
display_aspect_num=16
display_aspect_den=9
Once you restart OpenShot, you will see your custom profile appear in the list of
Profiles.
Import & Export
Video editing projects (including tracks, clips, and keyframes) can be imported and
exported from OpenShot Video Editor in widely supported formats (EDL: Edit Decision Lists,
and XML: Final Cut Pro format). For example, if you start editing a video in a different
program (Adobe Premier, Final Cut Pro, etc…), but later need to move all your edits to
OpenShot (or vice versa).
EDL (Edit Decision Lists)
The following features are supported when importing and exporting an EDL file with
OpenShot.
Example EDL format supported by OpenShot:
TITLE: Clips - TRACK 5
FCM: NON-DROP FRAME
001 BL V C 00:00:00:01 00:00:03:17 00:00:00:01 00:00:03:17
001 AX V C 00:00:00:01 00:00:10:01 00:00:03:17 00:00:13:17
* FROM CLIP NAME: Intro.png
002 BL V C 00:00:00:01 00:00:05:09 00:00:13:17 00:00:18:25
002 AX V C 00:00:00:01 00:00:10:01 00:00:18:25 00:00:28:25
* FROM CLIP NAME: FileName.mp4
* OPACITY LEVEL AT 00:00:00:01 IS 0.00% (REEL AX)
* OPACITY LEVEL AT 00:00:01:01 IS 100.00% (REEL AX)
* OPACITY LEVEL AT 00:00:09:01 IS 100.00% (REEL AX)
* OPACITY LEVEL AT 00:00:10:01 IS 0.00% (REEL AX)
003 BL V C 00:00:00:01 00:00:33:15 00:00:28:25 00:01:02:09
003 AX V C 00:00:14:25 00:00:34:29 00:01:02:09 00:01:22:13
003 AX A C 00:00:14:25 00:00:34:29 00:01:02:09 00:01:22:13
* FROM CLIP NAME: FileName2.mp4
004 BL V C 00:00:00:01 00:00:26:25 00:01:22:13 00:01:49:07
004 AX A C 00:00:00:01 00:02:20:01 00:01:49:07 00:04:09:07
* FROM CLIP NAME: Music.wav
* AUDIO LEVEL AT 00:00:00:01 IS -99.00 DB (REEL AX A1)
* AUDIO LEVEL AT 00:00:03:01 IS 0.00 DB (REEL AX A1)
* AUDIO LEVEL AT 00:02:17:01 IS 0.00 DB (REEL AX A1)
* AUDIO LEVEL AT 00:02:20:01 IS -99.00 DB (REEL AX A1)
XML (Final Cut Pro format)
The following features are supported when importing and exporting an XML file with
OpenShot. This XML format is supported in many video editors (not just Final Cut Pro). In
fact, most commercial video editors have some support for importing and exporting this
same XML format.
Example XML format supported by OpenShot (abbreviated):
<?xml version="1.0" ?>
<!DOCTYPE xmeml>
<xmeml version="4">
<sequence MZ.EditLine="3237704870400" MZ.Sequence.AudioTimeDisplayFormat="200" MZ.Sequence.EditingModeGUID="795454d9-d3c2-429d-9474-923ab13b7017" MZ.Sequence.PreviewFrameSizeHeight="480" MZ.Sequence.PreviewFrameSizeWidth="720" MZ.Sequence.PreviewRenderingClassID="1061109567" MZ.Sequence.PreviewRenderingPresetCodec="1685480224" MZ.Sequence.PreviewRenderingPresetPath="EncoderPresets/SequencePreview/795454d9-d3c2-429d-9474-923ab13b7017/QuickTime DV NTSC.epr" MZ.Sequence.PreviewUseMaxBitDepth="false" MZ.Sequence.PreviewUseMaxRenderQuality="false" MZ.Sequence.VideoTimeDisplayFormat="102" MZ.WorkInPoint="0" MZ.WorkOutPoint="5432902675200" MZ.ZeroPoint="8475667200" Monitor.ProgramZoomIn="0" Monitor.ProgramZoomOut="5432902675200" TL.SQAVDividerPosition="0.5" TL.SQAudioVisibleBase="0" TL.SQHeaderWidth="236" TL.SQHideShyTracks="0" TL.SQTimePerPixel="0.050923888888888894" TL.SQVideoVisibleBase="0" TL.SQVisibleBaseTime="0" explodedTracks="true" id="X3N90QWYU1">
<uuid>60cb1fb8-7dac-11e9-abb0-f81a67234bcb</uuid>
<duration>249.215625</duration>
<rate>
<timebase>30.0</timebase>
<ntsc>TRUE</ntsc>
</rate>
<name>Clips.xml</name>
<media>
<video>
<format>
<samplecharacteristics>
<rate>
<timebase>30.0</timebase>
<ntsc>TRUE</ntsc>
</rate>
<codec>...</codec>
<width>1280</width>
<height>720</height>
<anamorphic>FALSE</anamorphic>
<pixelaspectratio>NTSC-601</pixelaspectratio>
<fielddominance>lower</fielddominance>
<colordepth>24</colordepth>
</samplecharacteristics>
</format>
<track MZ.TrackTargeted="0" TL.SQTrackExpanded="0" TL.SQTrackExpandedHeight="25" TL.SQTrackShy="0">
<enabled>TRUE</enabled>
<locked>FALSE</locked>
<clipitem id="XAUWQHBX4K">
<name>Title.png</name>
<enabled>TRUE</enabled>
<duration>300.0</duration>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<start>340.79999999999995</start>
<end>640.8</end>
<in>0.0</in>
<out>300.0</out>
<pproTicksIn>0.0</pproTicksIn>
<pproTicksOut>76204800000000.0</pproTicksOut>
<alphatype>none</alphatype>
<pixelaspectratio>square</pixelaspectratio>
<anamorphic>FALSE</anamorphic>
<file id="FL840TGBJK">
<name>Title.png</name>
<pathurl>Title.png</pathurl>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<duration>301</duration>
<timecode>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00:00:00:00</string>
<frame>0</frame>
<displayformat>NDF</displayformat>
<reel>
<name>AX</name>
</reel>
</timecode>
<media>
<video>
<samplecharacteristics>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<width>720</width>
<height>480</height>
<anamorphic>FALSE</anamorphic>
<pixelaspectratio>square</pixelaspectratio>
<fielddominance>lower</fielddominance>
</samplecharacteristics>
</video>
<audio>
<samplecharacteristics>
<depth>16</depth>
<samplerate>48000</samplerate>
</samplecharacteristics>
<channelcount>2</channelcount>
</audio>
</media>
</file>
<filter>
<effect>
<name>Opacity</name>
<effectid>opacity</effectid>
<effectcategory>motion</effectcategory>
<effecttype>motion</effecttype>
<mediatype>video</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>opacity</parameterid>
<name>opacity</name>
<valuemin>0</valuemin>
<valuemax>100</valuemax>
<value>100</value>
<keyframe>
<when>1.0</when>
<value>100.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
<labels>
<label2>Violet</label2>
</labels>
</clipitem>
<clipitem id="A2ZIIOZCH9">
<name>FileName.mp4</name>
<enabled>TRUE</enabled>
<duration>1558.400001525879</duration>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<start>2214.0</start>
<end>3772.400001525879</end>
<in>0.0</in>
<out>1558.400001525879</out>
<pproTicksIn>0.0</pproTicksIn>
<pproTicksOut>395858534787597.6</pproTicksOut>
<alphatype>none</alphatype>
<pixelaspectratio>square</pixelaspectratio>
<anamorphic>FALSE</anamorphic>
<file id="SG00IW75Y5">
<name>FileName.mp4</name>
<pathurl>FileName.mp4</pathurl>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<duration>301</duration>
<timecode>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00:00:00:00</string>
<frame>0</frame>
<displayformat>NDF</displayformat>
<reel>
<name>AX</name>
</reel>
</timecode>
<media>
<video>
<samplecharacteristics>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<width>720</width>
<height>480</height>
<anamorphic>FALSE</anamorphic>
<pixelaspectratio>square</pixelaspectratio>
<fielddominance>lower</fielddominance>
</samplecharacteristics>
</video>
<audio>
<samplecharacteristics>
<depth>16</depth>
<samplerate>2</samplerate>
</samplecharacteristics>
<channelcount>48000</channelcount>
</audio>
</media>
</file>
<filter>
<effect>
<name>Opacity</name>
<effectid>opacity</effectid>
<effectcategory>motion</effectcategory>
<effecttype>motion</effecttype>
<mediatype>video</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>opacity</parameterid>
<name>opacity</name>
<valuemin>0</valuemin>
<valuemax>100</valuemax>
<value>100</value>
<keyframe>
<when>1.0</when>
<value>100.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
<labels>
<label2>Violet</label2>
</labels>
</clipitem>
</track>
<track MZ.TrackTargeted="0" TL.SQTrackExpanded="0" TL.SQTrackExpandedHeight="25" TL.SQTrackShy="0">
<enabled>TRUE</enabled>
<locked>FALSE</locked>
<clipitem id="0E25FKQBWG">
<name>Credits.png</name>
<enabled>TRUE</enabled>
<duration>300.0</duration>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<start>105.6</start>
<end>405.59999999999997</end>
<in>0.0</in>
<out>300.0</out>
<pproTicksIn>0.0</pproTicksIn>
<pproTicksOut>76204800000000.0</pproTicksOut>
<alphatype>none</alphatype>
<pixelaspectratio>square</pixelaspectratio>
<anamorphic>FALSE</anamorphic>
<file id="KTBZK4AR5A">
<name>Credits.png</name>
<pathurl>Credits.png</pathurl>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<duration>301</duration>
<timecode>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00:00:00:00</string>
<frame>0</frame>
<displayformat>NDF</displayformat>
<reel>
<name>AX</name>
</reel>
</timecode>
<media>
<video>
<samplecharacteristics>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<width>720</width>
<height>480</height>
<anamorphic>FALSE</anamorphic>
<pixelaspectratio>square</pixelaspectratio>
<fielddominance>lower</fielddominance>
</samplecharacteristics>
</video>
<audio>
<samplecharacteristics>
<depth>16</depth>
<samplerate>48000</samplerate>
</samplecharacteristics>
<channelcount>2</channelcount>
</audio>
</media>
</file>
<filter>
<effect>
<name>Opacity</name>
<effectid>opacity</effectid>
<effectcategory>motion</effectcategory>
<effecttype>motion</effecttype>
<mediatype>video</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>opacity</parameterid>
<name>opacity</name>
<valuemin>0</valuemin>
<valuemax>100</valuemax>
<value>100</value>
<keyframe>
<when>1.0</when>
<value>100.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
<labels>
<label2>Violet</label2>
</labels>
</clipitem>
<clipitem id="YBPQ8J4LC9">
<name>Overlay.png</name>
<enabled>TRUE</enabled>
<duration>300.0</duration>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<start>564.0</start>
<end>864.0</end>
<in>0.0</in>
<out>300.0</out>
<pproTicksIn>0.0</pproTicksIn>
<pproTicksOut>76204800000000.0</pproTicksOut>
<alphatype>none</alphatype>
<pixelaspectratio>square</pixelaspectratio>
<anamorphic>FALSE</anamorphic>
<file id="MMRR3KIDHF">
<name>Overlay.png</name>
<pathurl>Overlay.png</pathurl>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<duration>301</duration>
<timecode>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00:00:00:00</string>
<frame>0</frame>
<displayformat>NDF</displayformat>
<reel>
<name>AX</name>
</reel>
</timecode>
<media>
<video>
<samplecharacteristics>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<width>720</width>
<height>480</height>
<anamorphic>FALSE</anamorphic>
<pixelaspectratio>square</pixelaspectratio>
<fielddominance>lower</fielddominance>
</samplecharacteristics>
</video>
<audio>
<samplecharacteristics>
<depth>16</depth>
<samplerate>48000</samplerate>
</samplecharacteristics>
<channelcount>2</channelcount>
</audio>
</media>
</file>
<filter>
<effect>
<name>Opacity</name>
<effectid>opacity</effectid>
<effectcategory>motion</effectcategory>
<effecttype>motion</effecttype>
<mediatype>video</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>opacity</parameterid>
<name>opacity</name>
<valuemin>0</valuemin>
<valuemax>100</valuemax>
<value>100</value>
<keyframe>
<when>1.0</when>
<value>0.0</value>
</keyframe>
<keyframe>
<when>31.0</when>
<value>100.0</value>
</keyframe>
<keyframe>
<when>271.0</when>
<value>100.0</value>
</keyframe>
<keyframe>
<when>301.0</when>
<value>0.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
<labels>
<label2>Violet</label2>
</labels>
</clipitem>
<clipitem id="SQ3995OKWV">
<name>FileName.mp4</name>
<enabled>TRUE</enabled>
<duration>603.9999999999999</duration>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<start>1868.0</start>
<end>2471.9999999999995</end>
<in>444.0</in>
<out>1048.0</out>
<pproTicksIn>112783104000000.0</pproTicksIn>
<pproTicksOut>266208768000000.0</pproTicksOut>
<alphatype>none</alphatype>
<pixelaspectratio>square</pixelaspectratio>
<anamorphic>FALSE</anamorphic>
<file id="SG00IW75Y5">
<name>FileName.mp4</name>
<pathurl>FileName.mp4</pathurl>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<duration>301</duration>
<timecode>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00:00:00:00</string>
<frame>0</frame>
<displayformat>NDF</displayformat>
<reel>
<name>AX</name>
</reel>
</timecode>
<media>
<video>
<samplecharacteristics>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<width>720</width>
<height>480</height>
<anamorphic>FALSE</anamorphic>
<pixelaspectratio>square</pixelaspectratio>
<fielddominance>lower</fielddominance>
</samplecharacteristics>
</video>
<audio>
<samplecharacteristics>
<depth>16</depth>
<samplerate>2</samplerate>
</samplecharacteristics>
<channelcount>48000</channelcount>
</audio>
</media>
</file>
<filter>
<effect>
<name>Opacity</name>
<effectid>opacity</effectid>
<effectcategory>motion</effectcategory>
<effecttype>motion</effecttype>
<mediatype>video</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>opacity</parameterid>
<name>opacity</name>
<valuemin>0</valuemin>
<valuemax>100</valuemax>
<value>100</value>
<keyframe>
<when>1.0</when>
<value>100.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
<labels>
<label2>Violet</label2>
</labels>
</clipitem>
</track>
</video>
<audio>
<numOutputChannels>2</numOutputChannels>
<format>
<samplecharacteristics>
<depth>16</depth>
<samplerate>44100</samplerate>
</samplecharacteristics>
</format>
<outputs>
<group>
<index>1</index>
<numchannels>1</numchannels>
<downmix>0</downmix>
<channel>
<index>1</index>
</channel>
</group>
<group>
<index>2</index>
<numchannels>1</numchannels>
<downmix>0</downmix>
<channel>
<index>2</index>
</channel>
</group>
</outputs>
<track MZ.TrackTargeted="1" PannerCurrentValue="0.5" PannerIsInverted="true" PannerName="Balance" PannerStartKeyframe="-91445760000000000,0.5,0,0,0,0,0,0" TL.SQTrackAudioKeyframeStyle="0" TL.SQTrackExpanded="0" TL.SQTrackExpandedHeight="25" TL.SQTrackShy="0" currentExplodedTrackIndex="0" premiereTrackType="Stereo" totalExplodedTrackCount="2">
<enabled>TRUE</enabled>
<locked>FALSE</locked>
<outputchannelindex>1</outputchannelindex>
<clipitem id="A2ZIIOZCH9-audio" premiereChannelType="stereo">
<name>FileName.mp4</name>
<enabled>TRUE</enabled>
<duration>1558.400001525879</duration>
<rate>
<timebase>30</timebase>
<ntsc>FALSE</ntsc>
</rate>
<start>2214.0</start>
<end>3772.400001525879</end>
<in>0.0</in>
<out>1558.400001525879</out>
<pproTicksIn>0.0</pproTicksIn>
<pproTicksOut>395858534787597.6</pproTicksOut>
<file id="SG00IW75Y5"/>
<sourcetrack>
<mediatype>audio</mediatype>
<trackindex>1</trackindex>
</sourcetrack>
<filter>
<effect>
<name>Audio Levels</name>
<effectid>audiolevels</effectid>
<effectcategory>audiolevels</effectcategory>
<effecttype>audiolevels</effecttype>
<mediatype>audio</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>level</parameterid>
<name>Level</name>
<valuemin>0</valuemin>
<valuemax>3.98109</valuemax>
<value>1.0</value>
<keyframe>
<when>1.0</when>
<value>1.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
</clipitem>
</track>
<track MZ.TrackTargeted="1" PannerCurrentValue="0.5" PannerIsInverted="true" PannerName="Balance" PannerStartKeyframe="-91445760000000000,0.5,0,0,0,0,0,0" TL.SQTrackAudioKeyframeStyle="0" TL.SQTrackExpanded="0" TL.SQTrackExpandedHeight="25" TL.SQTrackShy="0" currentExplodedTrackIndex="0" premiereTrackType="Stereo" totalExplodedTrackCount="2">
<enabled>TRUE</enabled>
<locked>FALSE</locked>
<outputchannelindex>2</outputchannelindex>
<clipitem id="SQ3995OKWV-audio" premiereChannelType="stereo">
<name>FileName.mp4</name>
<enabled>TRUE</enabled>
<duration>603.9999999999999</duration>
<rate>
<timebase>30</timebase>
<ntsc>FALSE</ntsc>
</rate>
<start>1868.0</start>
<end>2471.9999999999995</end>
<in>444.0</in>
<out>1048.0</out>
<pproTicksIn>112783104000000.0</pproTicksIn>
<pproTicksOut>266208768000000.0</pproTicksOut>
<file id="SG00IW75Y5"/>
<sourcetrack>
<mediatype>audio</mediatype>
<trackindex>2</trackindex>
</sourcetrack>
<filter>
<effect>
<name>Audio Levels</name>
<effectid>audiolevels</effectid>
<effectcategory>audiolevels</effectcategory>
<effecttype>audiolevels</effecttype>
<mediatype>audio</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>level</parameterid>
<name>Level</name>
<valuemin>0</valuemin>
<valuemax>3.98109</valuemax>
<value>1.0</value>
<keyframe>
<when>1.0</when>
<value>1.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
</clipitem>
<clipitem id="N2D64Q4B9F-audio" premiereChannelType="stereo">
<name>The Epic.wav</name>
<enabled>TRUE</enabled>
<duration>4200.46875</duration>
<rate>
<timebase>30</timebase>
<ntsc>FALSE</ntsc>
</rate>
<start>3276.0</start>
<end>7476.46875</end>
<in>0.0</in>
<out>4200.46875</out>
<pproTicksIn>0.0</pproTicksIn>
<pproTicksOut>1066986270000000.0</pproTicksOut>
<file id="PTWYH9FRCD">
<name>The Epic.wav</name>
<pathurl>The Epic.wav</pathurl>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<duration>4196</duration>
<timecode>
<rate>
<timebase>30</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00;00;00;00</string>
<frame>0</frame>
<displayformat>DF</displayformat>
</timecode>
<media>
<audio>
<samplecharacteristics>
<depth>16</depth>
<samplerate>44100</samplerate>
</samplecharacteristics>
<channelcount>2</channelcount>
</audio>
</media>
</file>
<sourcetrack>
<mediatype>audio</mediatype>
<trackindex>2</trackindex>
</sourcetrack>
<filter>
<effect>
<name>Audio Levels</name>
<effectid>audiolevels</effectid>
<effectcategory>audiolevels</effectcategory>
<effecttype>audiolevels</effecttype>
<mediatype>audio</mediatype>
<pproBypass>false</pproBypass>
<parameter authoringApp="OpenShot">
<parameterid>level</parameterid>
<name>Level</name>
<valuemin>0</valuemin>
<valuemax>3.98109</valuemax>
<value>1.0</value>
<keyframe>
<when>1.0</when>
<value>0.0</value>
</keyframe>
<keyframe>
<when>91.0</when>
<value>1.0</value>
</keyframe>
<keyframe>
<when>4111.0</when>
<value>1.0</value>
</keyframe>
<keyframe>
<when>4201.0</when>
<value>0.0</value>
</keyframe>
</parameter>
</effect>
</filter>
<logginginfo>
<description/>
<scene/>
<shottake/>
<lognote/>
<good/>
<originalvideofilename/>
<originalaudiofilename/>
</logginginfo>
<colorinfo>
<lut/>
<lut1/>
<asc_sop/>
<asc_sat/>
<lut2/>
</colorinfo>
</clipitem>
</track>
</audio>
</media>
<timecode>
<rate>
<timebase>30.0</timebase>
<ntsc>TRUE</ntsc>
</rate>
<string>00;00;00;01</string>
<frame>1</frame>
<displayformat>DF</displayformat>
</timecode>
</sequence>
</xmeml>
Developers
If you are a programmer (or want to become a programmer), and are interested in developing
new features, fixing bugs, or improving the user interface for OpenShot, the following
sections will explain how to get started and get involved!
The Big Picture
OpenShot Video Editor has 3 main components, a Python & PyQt user interface (openshot-qt),
a C++ audio library (libopenshot-audio) and a C++ video library (libopenshot). If you are
not familiar with Python, PyQt, or C++, those would be great topics to research and learn
more about at this point.
However, many bugs can be fixed and new features added with only Python knowledge, since
the C++ components are not involved in the user interface at all. Python is an amazing
language, and is super fun to learn, and is the only prerequisite skill needed to become
an OpenShot developer!
WARNING:
The instructions that follow are for Ubuntu Linux, which is the easiest environment to
configure for OpenShot development. If you are using another OS, I suggest running a
virtual machine with Ubuntu LTS before continuing any further.
If you must use a Windows or Mac system for development, start by referring to the
build notes in the libopenshot wiki. Building the library with all of its dependencies
is the most challenging part of the process.
• Windows Build Instructions
• Mac Build Instructions
Getting the Latest Source Code
Before we can fix any bugs or add any features, we need to get the source code onto your
computer.
Use git to clone our 3 repositories:
git clone https://github.com/OpenShot/libopenshot-audio.git
git clone https://github.com/OpenShot/libopenshot.git
git clone https://github.com/OpenShot/openshot-qt.git
Configuring your Development Environment
In order to actually compile or run OpenShot, we need to install some dependencies on your
system. The easiest way to accomplish this is with our Daily PPA. A PPA is an unofficial
Ubuntu repository, which has our software packages available to download and install.
sudo add-apt-repository ppa:openshot.developers/libopenshot-daily
sudo apt-get update
sudo apt-get install openshot-qt \
cmake \
libx11-dev \
libasound2-dev \
libavcodec-dev \
libavdevice-dev \
libavfilter-dev \
libavformat-dev \
libavresample-dev \
libavutil-dev \
libfdk-aac-dev \
libfreetype6-dev \
libjsoncpp-dev \
libmagick++-dev \
libopenshot-audio-dev \
libswscale-dev \
libunittest++-dev \
libxcursor-dev \
libxinerama-dev \
libxrandr-dev \
libzmq3-dev \
pkg-config \
python3-dev \
qtbase5-dev \
qtmultimedia5-dev \
swig
At this point, you should have all 3 OpenShot components source code cloned into local
folders, the OpenShot daily PPA installed, and all of the required development and runtime
dependencies installed. This is a great start, and we are now ready to start compiling
some code!
libopenshot-audio (Build Instructions)
This library is required for audio playback and audio effects. It is based on the JUCE
audio framework. Here are the commands to build it:
cd libopenshot-audio
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=dist ..
make
make install
Essentially, we are switching to the libopenshot-audio/build folder, then running cmake ..
on the parent folder. This finds dependencies and creates all the needed Makefiles used
to compile this library. Then make uses those Makefiles to compile this library, and make
install installs them in the location we specified. If CMAKE_INSTALL_PREFIX isn’t set,
the files will install to /usr/local/ (by default) and make install will require
administrative privileges to run.
libopenshot (Build Instructions)
This library is required for video decoding, encoding, animation, and just about
everything else. It does all the heavy lifting of video editing and video playback. Here
are the commands to build it:
cd libopenshot
mkdir build
cd build
cmake -DLIBOPENSHOT_AUDIO_DIR=../../libopenshot-audio/build/dist ..
make
Essentially, we are switching to the libopenshot/build folder, then running cmake .. on
the parent folder. This finds dependencies and creates all the needed Makefiles used to
compile this library. Then make uses those Makefiles to compile this library. Because we
provided the location of our compiled libopenshot-audio installation, that version of the
library will be used instead of the system version (if any).
We don’t install our libopenshot after building, because we don’t need to. For testing
purposes, we can tell OpenShot to use libopenshot right from our build directory.
openshot-qt (Launch Instructions)
This is our main PyQt Python application. Because it is written in Python, it does not
require any compiling to run. To launch OpenShot from the source code with our
newly-built libopenshot-audio and libopenshot libraries, use the following commands:
cd openshot-qt
PYTHONPATH=../libopenshot/build/src/bindings/python
python3 src/launch.py
This should launch the OpenShot user interface. Any changes you have made to the source
code files (*.py Python files, *.ui PyQt UI files, etc…) will be included. This requires
the libopenshot-audio and libopenshot libraries, and if anything went wrong with the steps
above, OpenShot will likely not launch.
If OpenShot launches at this point, congratulations! You now have a working local version
of OpenShot, which is running off your local source code. Try making some changes to the
source code and re-launch OpenShot… you should now see your changes!
GitHub Issues
Now that you have successfully compiled and launched OpenShot Video Editor, be sure to
check out our list of bug reports on GitHub: OpenShot Issues. Also, feel free to send me
an email: jonathan@openshot.org and introduce yourself! I’m always here to help if you
have any questions.
Share your Changes
Once you have fixed a bug or added an amazing new feature, be sure to share it with the
OpenShot team. Ideally, we can merge this into our main source code branch. The easiest
way to share your changes is by creating a fork of our repo, pushing your changes back to
GitHub, and creating a Pull Request. A Pull Request lets the OpenShot team know you have
changes ready to be merged. Then we can review things, give feedback, and hopefully merge
your changes into the main branch.
Contributing
Did you find a bug?
• Please check if this bug was already reported by searching on GitHub under Issues.
• If you’re unable to find an open issue addressing the problem, open a new one. Be sure
to include a title and clear description, as much relevant information as possible, and
the steps to reproduce the crash or issue.
• Please attach log files if you are reporting a crash. Otherwise, we will not be able to
determine the cause of the crash.
Please download our latest daily installer:
1. openshot.org/download - click the ‘DAILY BUILDS’ button, then grab the latest build
from the list. (Use the buttons below to download installers for a different Operating
System.)
2. Then enable ‘Debug Mode (Verbose)’ in the Preferences
3. Quit OpenShot and delete both log files:
• Windows: OpenShot stores its logs in your user profile directory (%USERPROFILE%, e.g.
C:\Users\username\)
• %USERPROFILE%/.openshot_qt/openshot-qt.log
• %USERPROFILE%/.openshot_qt/libopenshot.log
• Linux/MacOS: OpenShot stores its logs in your home directory ($HOME, e.g.
/home/username/)
• $HOME/.openshot_qt/openshot-qt.log
• $HOME/.openshot_qt/libopenshot.log
4. Re-launch OpenShot and trigger the crash as quickly as possible (to keep the log files
small)
5. Attach both log files
Did you write a patch that fixes a bug?
• Open a new GitHub pull request with the patch.
• Ensure the PR description clearly describes the problem and solution. Include the
relevant issue number if applicable.
• Before submitting, please ensure your PR passes all build / compilation / and unit
tests.
OpenShot Video Editor is a volunteer effort, and a labor of love. Please be patient with
any issues you find, and feel free to get involved and help us fix them!
Thanks!
OpenShot Team
Learn More
We are working hard to expand this user guide, but if you are stuck and don’t know where
to turn, please submit a question or bug report here: Issues.
AUTHOR
Jonathan Thomas
COPYRIGHT
2008-2023 OpenShot Studios, LLC