.\" Man page generated from reStructuredText.
.
.TH "OPENSHOT-QT" "1" "Jun 20, 2020" "2.5" "OpenShot Video Editor"
.SH NAME
openshot-qt \- OpenShot Video Editor Documentation
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.sp
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.
.sp
Learning to use OpenShot is easy, and with this guide, you will be a master in no
time at all!
.SH TABLE OF CONTENTS:
.SS Introduction
.sp
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.
.SS Features
.INDENT 0.0
.IP \(bu 2
Cross\-platform (Supports Linux, OS X, and Windows)
.IP \(bu 2
Support for many video, audio, and image formats (based on FFmpeg)
.IP \(bu 2
Powerful curve\-based Key frame animations
.IP \(bu 2
Desktop integration (drag and drop support)
.IP \(bu 2
Unlimited tracks / layers
.IP \(bu 2
Clip resizing, scaling, trimming, snapping, rotation, and cutting
.IP \(bu 2
Video transitions with real\-time previews
.IP \(bu 2
Compositing, image overlays, watermarks
.IP \(bu 2
Title templates, title creation, sub\-titles
.IP \(bu 2
2D animation support (image sequences)
.IP \(bu 2
3D animated titles (and effects)
.IP \(bu 2
SVG friendly, to create and include vector titles and credits
.IP \(bu 2
Scrolling motion picture credits
.IP \(bu 2
Advanced Timeline (including Drag & drop, scrolling, panning, zooming, and snapping)
.IP \(bu 2
Frame accuracy (step through each frame of video)
.IP \(bu 2
Time\-mapping and speed changes on clips (slow/fast, forward/backward, etc…)
.IP \(bu 2
Audio mixing and editing
.IP \(bu 2
Digital video effects, including brightness, gamma, hue, greyscale, chroma key (bluescreen / greenscreen) , and many more!
.UNINDENT
.SS Screenshot
[image]
.SS System Requirements
.sp
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:
.INDENT 0.0
.IP \(bu 2
64\-bit Operating System (Linux, OS X, Windows 7/8/10)
.IP \(bu 2
Multi\-core processor with 64\-bit support
.IP \(bu 2
4GB of RAM (16GB recommended)
.IP \(bu 2
500 MB of hard\-disk space for installation
.IP \(bu 2
Optional: Solid\-state drive (SSD), if utilizing disk\-caching (and an additional 10GB of
hard\-disk space)
.UNINDENT
.SS License
.sp
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.
.SS Getting Started
.sp
OpenShot Video Editor is available on most operating systems (including Linux, Mac, and Windows).
Visit the official download page and grab the latest and greatest version:
\fI\%https://www.openshot.org/download/\fP\&.
.SS Linux
.sp
Depending on which Linux distribution you use, there are likely many ways to install OpenShot. The
easiest way to ensure you have the very latest version, is to download an AppImage from the
project website (listed above). Once downloaded, right click on the AppImage file, choose
Properties, and mark the file as \fBExecutable\fP\&. Now, go ahead and double click the
AppImage to launch it.
.SS Mac
.sp
Download the DMG file from the project website (listed above), double click it, and then drag
the OpenShot application icon into your \fBApplications\fP shortcut. This is very similar to how most
other Mac applications are installed. Now launch OpenShot from Launchpad.
.SS Windows
.sp
Download the Windows installer executable from the project website (listed above), double click it,
and follow the directions on screen. Once completed, OpenShot will be installed and available
in your Start menu.
.SS Quick Tutorial
.sp
Using OpenShot is very easy, and this tutorial will take you through the basics in
\fBunder 5 minutes\fP\&. After this tutorial, you will be able to make a simple photo
slide\-show with music.
.SS Step 1 – Import Photos & Music
.sp
Before we can begin making a video, we need to import files into OpenShot. Drag and
drop a few images (*.JPG, *.PNG, etc…) and a music file (most formats will work)
from your Desktop to OpenShot. Be sure to drop the files where the
arrow in the illustration is pointing to.
[image]
.SS Step 2 – Arrange Photos on Timeline
.sp
Next, drag each photo onto 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]
.SS Step 3 – Add Music to Timeline
.sp
To make our photo slide\-show more interesting, we need to add some music. You should have
imported a music file in step 1. Click on the music file, and drag it onto the timeline. If
the song is too long, grab the right edge of your music clip, and resize it smaller.
[image]
.SS Step 4 – Preview your Project
.sp
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]
.SS Step 5 – Export your Video
.sp
Once you are happy with your photo slide\-show video, 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…).
.sp
Click on the Export Video icon at the top of the screen (or use the \fBFile > Export Video\fP menu).
Choose from one of the many preset export options, and click the \fIExport Video\fP button.
[image]
.sp
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!
.SS Main Window
.sp
OpenShot Video Editor has one main window which contains most of the information, buttons,
and menus needed to edit your video project.
.SS Overview
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Main Toolbar
T}	T{
Contains buttons to open, save, and export your video project.
T}
_
T{
2
T}	T{
Function Tabs
T}	T{
Switch between Project Files, Transitions, and Effects.
T}
_
T{
3
T}	T{
Project Files
T}	T{
All audio, video, and image files that have been imported into your project.
T}
_
T{
4
T}	T{
Preview Window
T}	T{
This is the area that the video will playback on the screen.
T}
_
T{
5
T}	T{
Edit Toolbar
T}	T{
This toolbar contains buttons used for snapping, inserting markers, and jumping between markers.
T}
_
T{
6
T}	T{
Zoom Slider
T}	T{
This slider will adjust the time\-scale of your timeline.
T}
_
T{
7
T}	T{
Play\-head / Ruler
T}	T{
The ruler shows the time\-scale, and the red line is the play\-head. The play\-head represents the current playback position.
T}
_
T{
8
T}	T{
Timeline
T}	T{
The timeline visualizes your video project, and each clip and transition in your project.
T}
_
T{
9
T}	T{
Filter
T}	T{
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.
T}
_
.TE
.sp
For step\-by\-step instructions on the basic usage of OpenShot, be sure to read the
quick_tutorial_ref\&.
.SS Built\-in Tutorial
.sp
When you first launch OpenShot, you will be presented with a friendly built\-in tutorial. It will point out and explain
the basics. Clicking \fBNext\fP will jump to the next topic. You can always view this tutorial again from the \fBHelp→Tutorial\fP menu.
[image]
.SS Tracks & Layers
.sp
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.
.sp
For example, imagine a 3 track video project
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Top Track
T}	T{
Clips on this track will always be on top and visible
T}
_
T{
2
T}	T{
Middle Track
T}	T{
Clips in the middle (might or might not be visible, depending on what is above them)
T}
_
T{
3
T}	T{
Bottom Track
T}	T{
Clips on this track will always be on the bottom
T}
_
.TE
.SS Keyboard Shortcuts
.sp
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!
.TS
center;
|l|l|.
_
T{
Shortcut
T}	T{
Action
T}
_
T{
Ctrl+H
T}	T{
About OpenShot
T}
_
T{
Ctrl+M
T}	T{
Add Marker
T}
_
T{
Ctrl+Shift+T
T}	T{
Add Track
T}
_
T{
Ctrl+W
T}	T{
Add to Timeline
T}
_
T{
Ctrl+B
T}	T{
Animated Title
T}
_
T{
Ctrl+P
T}	T{
Choose Profile
T}
_
T{
Ctrl+C
T}	T{
Copy
T}
_
T{
Delete
T}	T{
Delete Item
T}
_
T{
Backspace
T}	T{
Delete Item
T}
_
T{
Ctrl+D
T}	T{
Details View
T}
_
T{
Ctrl+E
T}	T{
Export Video
T}
_
T{
L
T}	T{
Fast Forward
T}
_
T{
F11
T}	T{
Fullscreen
T}
_
T{
Ctrl+F
T}	T{
Import Files
T}
_
T{
Ctrl+End
T}	T{
Jump to End
T}
_
T{
Ctrl+Home
T}	T{
Jump to Start
T}
_
T{
Ctrl+N
T}	T{
New Project
T}
_
T{
Right
T}	T{
Next Frame
T}
_
T{
Ctrl+Right
T}	T{
Next Marker
T}
_
T{
Ctrl+O
T}	T{
Open Project
T}
_
T{
Ctrl+V
T}	T{
Paste
T}
_
T{
Space
T}	T{
Play/Pause Toggle
T}
_
T{
Up
T}	T{
Play/Pause Toggle
T}
_
T{
Down
T}	T{
Play/Pause Toggle
T}
_
T{
K
T}	T{
Play/Pause Toggle
T}
_
T{
Ctrl+Shift+P
T}	T{
Preferences
T}
_
T{
Left
T}	T{
Previous Frame
T}
_
T{
Ctrl+Left
T}	T{
Previous Marker
T}
_
T{
Ctrl+I
T}	T{
Properties
T}
_
T{
Ctrl+Q
T}	T{
Quit
T}
_
T{
Ctrl+Y
T}	T{
Redo
T}
_
T{
J
T}	T{
Rewind
T}
_
T{
Ctrl+S
T}	T{
Save Project
T}
_
T{
Ctrl+Shift+S
T}	T{
Save Project As…
T}
_
T{
Ctrl+A
T}	T{
Select All
T}
_
T{
Ctrl+Shift+A
T}	T{
Select None
T}
_
T{
Ctrl+K
T}	T{
Slice All: Keep Both Sides
T}
_
T{
Ctrl+L
T}	T{
Slice All: Keep Left Side
T}
_
T{
Ctrl+J
T}	T{
Slice All: Keep Right Side
T}
_
T{
Ctrl+G
T}	T{
Toggle Snapping
T}
_
T{
Ctrl+X
T}	T{
Split Clip
T}
_
T{
Ctrl+Shift+D
T}	T{
Thumbnail View
T}
_
T{
Ctrl+T
T}	T{
Title Editor
T}
_
T{
Ctrl+Z
T}	T{
Undo
T}
_
T{
=
T}	T{
Zoom In
T}
_
T{
–
T}	T{
Zoom Out
T}
_
T{
Ctrl+Scroll
T}	T{
Zoom In/Out
T}
_
T{
Ctrl+Middle Button
T}	T{
Scroll Timeline
T}
_
.TE
.SS Files
.sp
Before we can begin making a video, we need to import files into OpenShot. Most media file types are
recognized, such as videos, images, and audio files. Files can be viewed and managed in the \fBProject Files\fP panel.
.SS Import Files
.sp
There are many ways to import media files into OpenShot.
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Drag and Drop
T}	T{
Drag and drop the files from your file manager (file explorer, finder, etc…)
T}
_
T{
Right Click→Import
T}	T{
Right click in the \fBProject Files\fP panel, choose \fBImport Files…\fP
T}
_
T{
File Menu→Import
T}	T{
File menu→Import Files…
T}
_
T{
Import Files Toolbar
T}	T{
Click the \fBImport Files…\fP toolbar button (on the top menu)
T}
_
.TE
[image]
.SS File Menu
.sp
To view the file menu, right click on a file (in the \fBProject Files\fP panel). Here are the actions you can use from the
file menu.
[image]
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Import Files…
T}	T{
Import files into your project
T}
_
T{
Thumbnail/Detail
T}	T{
Toggle the view between details and thumbnails
T}
_
T{
Preview File
T}	T{
Preview a media file
T}
_
T{
Split Clip…
T}	T{
Split a file into many smaller clips
T}
_
T{
Edit Title
T}	T{
Edit an existing title SVG file
T}
_
T{
Duplicate Title
T}	T{
Make a copy, and then edit the copied title SVG file
T}
_
T{
Add to Timeline
T}	T{
Add many files to the timeline in one step
T}
_
T{
File Properties
T}	T{
View the properties of a file, such as frame rate, size, etc…
T}
_
T{
Remove from Project
T}	T{
Remove a file from the project
T}
_
.TE
.SS Split Clip
.sp
If you need to cut a file into many smaller clips before editing, the \fBSplit Clip\fP 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]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Start of Clip
T}	T{
Choose the starting frame of your clip by clicking this button
T}
_
T{
2
T}	T{
End of Clip
T}	T{
Choose the ending frame of your clip by clicking this button
T}
_
T{
3
T}	T{
Name of Clip
T}	T{
Enter an optional name
T}
_
T{
4
T}	T{
Create Clip
T}	T{
Create the clip (which resets this dialog, so you can repeat these steps for each clip)
T}
_
.TE
.SS Add to Timeline
.sp
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 \fBAdd to Timeline\fP dialog can automate this task for you. First, select
all files you need to add, right click, and choose Add to Timeline.
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Selected Files
T}	T{
The list of selected files that need to be added to the timeline
T}
_
T{
2
T}	T{
Order of Files
T}	T{
Use these buttons to reorder the list of files (move up, move down, randomize, remove)
T}
_
T{
3
T}	T{
Timeline Position
T}	T{
Choose the starting position and track where these files need to be inserted on the timeline
T}
_
T{
4
T}	T{
Fade Options
T}	T{
Fade in, fade out, both, or none
T}
_
T{
5
T}	T{
Zoom Options
T}	T{
Zoom in, zoom out, or none
T}
_
T{
6
T}	T{
Transitions
T}	T{
Choose a specific transition to use between files, random, or none
T}
_
.TE
.SS Properties
.sp
To view the properties of any imported file in your video project, right click on the file, and choose \fBFile Properties\fP\&.
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]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
File Properties
T}	T{
Select an image sequence in the \fBProject Files\fP panel, right click and choose \fBFile Properties\fP
T}
_
T{
2
T}	T{
Frame Rate
T}	T{
For image sequences, you can also adjust the frame rate of the animation
T}
_
.TE
.SS Clips
.sp
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.
.SS Overview
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Clip 1
T}	T{
A video clip
T}
_
T{
2
T}	T{
Transition
T}	T{
A gradual fade transition between the 2 clips
T}
_
T{
3
T}	T{
Clip 2
T}	T{
An image clip
T}
_
.TE
.SS Cutting & Slicing
.sp
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:
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Slice
T}	T{
When the play\-head (i.e. red playback line) is overlapping a clip, right click on the clip, and choose Slice
T}
_
T{
Slice All
T}	T{
When the play\-head is overlapping many clips, right click on the play\-head, and choose Slice All (it will cut all intersecting clips)
T}
_
T{
Resizing Edge
T}	T{
Mouse over the edge of a clip, and resize the edge
T}
_
T{
Split Dialog
T}	T{
Right click on a file, and choose \fBSplit Clip\fP\&. A dialog will appear which allows for creating lots of small cuts in a single video file.
T}
_
T{
Razor Tool
T}	T{
The razor tool cuts a clip wherever you click, so be careful. Easy and dangerous.
T}
_
.TE
.sp
Keep in mind that all of the above cutting methods also have keyboard_shortcut_ref, to save even more time.
.SS Preset Menu
.sp
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]
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Fade
T}	T{
Fade in or out a clip (often easier than using a transition)
T}
_
T{
Animate
T}	T{
Zoom and slide a clip
T}
_
T{
Rotate
T}	T{
Rotate or flip a video
T}
_
T{
Layout
T}	T{
Make a video smaller or larger, and snap to any corner
T}
_
T{
Time
T}	T{
Reverse and speed up or slow down video
T}
_
T{
Volume
T}	T{
Fade in or out the volume for a clip
T}
_
T{
Separate Audio
T}	T{
Create a clip for each audio track
T}
_
T{
Slice
T}	T{
Cut the clip at the play\-head position
T}
_
T{
Transform
T}	T{
Enable transform mode
T}
_
T{
Display
T}	T{
Show waveform or thumbnail for a clip
T}
_
T{
Properties
T}	T{
Show the properties panel for a clip
T}
_
T{
Copy / Paste
T}	T{
Copy and paste key frames or duplicate an entire clip (with all key frames)
T}
_
T{
Remove Clip
T}	T{
Remove a clip from the timeline
T}
_
.TE
.SS Transform
.sp
To quickly adjust the location and scale of a clip, select a clip on the timeline, right click and choose \fBTransform\fP\&.
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]
.sp
For more info on key frames and animation, see animation_ref\&.
.SS Effects
.sp
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]
.SS Properties
.sp
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 \fBProperties\fP\&. 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.
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Gravity Type
T}	T{
The gravity of a clip determines where it snaps to it’s parent
T}
_
T{
Scale Type
T}	T{
The scale determines how a clip should be resized to fit it’s parent
T}
_
T{
Frame Display Type
T}	T{
The format to display the frame number (if any)
T}
_
T{
Scale X
T}	T{
Curve representing the horizontal scaling in percent (0 to 1)
T}
_
T{
Scale Y
T}	T{
Curve representing the vertical scaling in percent (0 to 1)
T}
_
T{
Location X
T}	T{
Curve representing the relative X position in percent based on the gravity (\-1 to 1)
T}
_
T{
Location Y
T}	T{
Curve representing the relative Y position in percent based on the gravity (\-1 to 1)
T}
_
T{
Rotation
T}	T{
Curve representing the rotation (0 to 360)
T}
_
T{
Alpha
T}	T{
Curve representing the alpha (1 to 0)
T}
_
T{
Time
T}	T{
Curve representing the frames over time to play (used for speed and direction of video)
T}
_
T{
Volume
T}	T{
Curve representing the volume (0 to 1)
T}
_
T{
Shear X
T}	T{
Curve representing X shear angle in degrees (\-45.0=left, 45.0=right)
T}
_
T{
Shear Y
T}	T{
Curve representing Y shear angle in degrees (\-45.0=down, 45.0=up)
T}
_
T{
Channel Filter
T}	T{
A number representing an audio channel to filter (clears all other channels)
T}
_
T{
Channel Mapping
T}	T{
A number representing an audio channel to output (only works when filtering a channel)
T}
_
T{
Has Audio
T}	T{
An optional override to determine if this clip has audio (\-1=undefined, 0=no, 1=yes)
T}
_
T{
Has Video
T}	T{
An optional override to determine if this clip has video (\-1=undefined, 0=no, 1=yes)
T}
_
T{
Waveform
T}	T{
Should a waveform be used instead of the clip’s image
T}
_
T{
Waveform Color
T}	T{
Curve representing the color of the audio wave form
T}
_
.TE
.sp
For more info on key frames and animation, see animation_ref\&.
.SS Transitions
.sp
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 \fBTransitions\fP panel. A transition must be placed on top of a clip (overlapping it),
with the most common location being the beginning or end.
.SS Overview
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Clip 1
T}	T{
A video clip
T}
_
T{
2
T}	T{
Transition
T}	T{
A gradual fade transition between the 2 clips, created automatically by overlapping the clips.
T}
_
T{
3
T}	T{
Clip 2
T}	T{
An image clip
T}
_
.TE
.SS Direction
.sp
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 \fBReverse Transition\fP to change the direction of the fade. You can also manually adjust
the \fBBrightness\fP curve, animating the fade in any way you wish.
[image]
.SS Cutting & Slicing
.sp
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:
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Slice
T}	T{
When the play\-head (i.e. red playback line) is overlapping a transition, right click on the transition, and choose Slice
T}
_
T{
Slice All
T}	T{
When the play\-head is overlapping many transitions, right click on the play\-head, and choose Slice All (it will cut all intersecting transitions)
T}
_
T{
Resizing Edge
T}	T{
Mouse over the edge of a transition, and resize the edge
T}
_
T{
Razor Tool
T}	T{
The razor tool cuts a transition wherever you click, so be careful. Easy and dangerous.
T}
_
.TE
.sp
Keep in mind that all of the above cutting methods also have keyboard_shortcut_ref\&.
.SS Mask
.sp
Like clips_ref, transitions also have properties which can be animated over time. The fade (or wipe) can be adjusted
with the \fBBrightness\fP curve, or held at a constant value to create a transparency mask on top of a clip.
.SS Custom Transition
.sp
Any greyscale image can be used as a transition (or mask), by adding it to your \fI/.openshot_qt/transitions/\fP 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.
.SS Properties
.sp
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 \fBProperties\fP\&. 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.
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Brightness
T}	T{
Curve representing the brightness of the transition image, which affects the fade/wipe (\-1 to 1)
T}
_
T{
Contrast
T}	T{
Curve representing the contrast of the transition image, which affects the softness/hardness of the fade/wipe (0 to 20)
T}
_
T{
Replace Image
T}	T{
For debugging a problem, this property displays the transition image (instead of becoming a transparency)
T}
_
.TE
.SS Animation
.sp
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.
.SS Overview
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Green Property
T}	T{
When the play\-head is on a key frame, the property appears green
T}
_
T{
1
T}	T{
Blue Property
T}	T{
When the play\-head is on an interpolated value, the property appears blue
T}
_
T{
2
T}	T{
Value Slider
T}	T{
Click and drag your mouse to adjust the value (this automatically creates a key frame if needed)
T}
_
T{
3
T}	T{
Play\-head
T}	T{
Position the play\-head over a clip where you need a key frame
T}
_
T{
4
T}	T{
Key frame Markers
T}	T{
Small green tick marks are drawn at all key frame positions (on a clip)
T}
_
.TE
.SS Key Frames
.sp
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.
.sp
To adjust the \fBinterpolation mode\fP, right click on the small graph icon next to a property value.
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
Bézier
T}	T{
Interpolated values use a quadratic curve, and ease\-in and ease\-out
T}
_
T{
Linear
T}	T{
Interpolated values are calculated linear (each step value is equal)
T}
_
T{
Constant
T}	T{
Interpolated values stay the same until the next key frame, and jump to the new value
T}
_
.TE
.sp
For more info on clip properties, see clip_properties_ref\&. For more info on preset animations, see clip_presets_ref\&.
For more info on creating key frames for location and scale, see clip_transform_ref\&.
.SS Bézier Presets
.sp
When using a Bézier curve for animation, OpenShot includes more than 20 curve presets (which affect the shape
of the curve). For example, \fBEase\-In\fP has a more gradual slope at the beginning, making an animation move slower at
the beginning, and faster at the end. \fBEase\-In/Out (Back)\fP has a gradual beginning and ending, but actually goes past
the expected value and then back (producing a bounce effect).
.sp
To choose a curve preset, right click on the small graph icon next to a key frame.
[image]
.SS Image Sequences
.sp
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.
.sp
To adjust the frame rate of the animation, right click and choose \fBFile Properties\fP in the \fBProject Files\fP panel,
and adjust the frame rate. Once you have set the correct frame rate, drag the animation onto the timeline.
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
File Properties
T}	T{
Select an image sequence in the \fBProject Files\fP panel, right click and choose \fBFile Properties\fP
T}
_
T{
2
T}	T{
Frame Rate
T}	T{
Adjust the frame rate of the animation. Typically, hand\-drawn animations use 12 frames per second.
T}
_
.TE
.SS Titles
.sp
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
\fBCtrl+T\fP\&.
.SS Overview
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Choose a Template
T}	T{
Choose from any available vector title template
T}
_
T{
2
T}	T{
Preview Title
T}	T{
Preview your title as you make changes
T}
_
T{
3
T}	T{
Title Properties
T}	T{
Change the text, colors, or edit in an advanced SVG image editor (such as Inkscape)
T}
_
T{
4
T}	T{
Save
T}	T{
Save and add the title to your project
T}
_
.TE
.SS Custom Titles
.sp
OpenShot can use any vector SVG image file as a title template. Just add an SVG image file to your \fI/.openshot_qt/titles/\fP
folder, and it will appear in OpenShot’s title editor after you restart OpenShot. You can also right click on any SVG
files in your \fBProject Files\fP panel, and choose \fBEdit Title\fP or \fBDuplicate Title\fP\&.
.SS 3D Animated Titles
.sp
Adding a 3D animated title is just as easy, using our \fBAnimated Title\fP 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 \fBCtrl+B\fP\&.
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Choose a Template
T}	T{
Choose from any available 3D title templates
T}
_
T{
2
T}	T{
Preview Title
T}	T{
Preview your title as you make changes
T}
_
T{
3
T}	T{
Title Properties
T}	T{
Change the text, colors, and advanced properties
T}
_
T{
4
T}	T{
Render
T}	T{
Render the 3D animation, and add it to your project
T}
_
.TE
.sp
This feature requires the latest version of Blender (\fI\%https://www.blender.org/download/\fP) be installed, and the OpenShot
\fBPreferences\fP updated with the correct path to the Blender executable (for example: \fI/home/USER/blender\-2.78/blender\fP).
.SS Profiles
.sp
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.
.SS Project Profile
.sp
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]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Title Bar
T}	T{
The title bar of OpenShot displays the current profile
T}
_
T{
2
T}	T{
Profile Button
T}	T{
Launch the profiles dialog
T}
_
T{
3
T}	T{
Choose Profile
T}	T{
Select a profile for editing and preview
T}
_
.TE
.SS Export Profile
.sp
The export profile always defaults to your current project profile, but can be changed to target different profiles.
[image]
.TS
center;
|l|l|l|.
_
T{
#
T}	T{
Name
T}	T{
Description
T}
_
T{
1
T}	T{
Choose Profile
T}	T{
Select a profile for export
T}
_
.TE
.SS Custom Profile
.sp
Although OpenShot has more than 70 profiles included by default, you can also create your own custom profiles. Create a
new file in the \fI/.openshot_qt/profiles/\fP folder. Use the following text as your template (i.e. copy and paste this
into the file):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
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
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Once you restart OpenShot, you will see your custom profile appear in the list of Profiles.
.SS Import & Export
.sp
Video editing projects (including tracks, clips, and keyframes) can be \fBimported\fP and \fBexported\fP from OpenShot
Video Editor in widely supported formats (\fBEDL\fP: Edit Decision Lists, and \fBXML\fP: 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).
.SS EDL (Edit Decision Lists)
.sp
The following features are supported when importing and exporting an EDL file with OpenShot.
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
EDL Format
T}	T{
CMX\-3600 (a very widely supported variation)
T}
_
T{
Single Track
T}	T{
Only a single track can be imported at a time (this is a limitation of the EDL format)
T}
_
T{
Tape Name
T}	T{
Only \fBAX\fP and \fBBL\fP tape names are currently supported in OpenShot
T}
_
T{
Edits (V and A)
T}	T{
Only edits are currently supported (transitions are not yet supported)
T}
_
T{
Opacity
T}	T{
Opacity keyframes are supported
T}
_
T{
Audio Levels
T}	T{
Volume keyframes are supported
T}
_
.TE
.sp
Example EDL format supported by OpenShot:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
 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)
.ft P
.fi
.UNINDENT
.UNINDENT
.SS XML (Final Cut Pro format)
.sp
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.
.TS
center;
|l|l|.
_
T{
Name
T}	T{
Description
T}
_
T{
XML Format
T}	T{
Final Cut Pro format (but most commercial video editors also support this format)
T}
_
T{
All Tracks
T}	T{
All video and audio tracks are supported
T}
_
T{
Edits
T}	T{
All clips on all tracks are supported (video, image, and audio files). Transitions are not yet supported.
T}
_
T{
Opacity
T}	T{
Opacity keyframes are supported
T}
_
T{
Audio Levels
T}	T{
Volume keyframes are supported
T}
_
.TE
.sp
Example XML format supported by OpenShot (abbreviated):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
<?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>
.ft P
.fi
.UNINDENT
.UNINDENT
.SS Developers
.sp
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!
.SS The Big Picture
.sp
OpenShot Video Editor has 3 main components, a Python & PyQt user interface
(\fI\%openshot\-qt\fP), a C++ audio library
(\fI\%libopenshot\-audio\fP) and a C++ video library
(\fI\%libopenshot\fP). If you are not familiar with Python,
PyQt, or C++, those would be great topics to research and learn more about at this point.
.sp
However, many bugs and new features can be 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!
.sp
\fBWARNING:\fP
.INDENT 0.0
.INDENT 3.5
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.
.sp
If you must use a Windows or Mac system for development,
start by referring to the build notes in the \fBlibopenshot\fP wiki.
Building the library with all of its dependencies is the most challenging part of the process.
.INDENT 0.0
.IP \(bu 2
\fI\%Windows Build Instructions\fP
.IP \(bu 2
\fI\%Mac Build Instructions\fP
.UNINDENT
.UNINDENT
.UNINDENT
.SS Getting the Latest Source Code
.sp
Before we can fix any bugs or add any features, we need to get the source code onto your
computer.
.sp
Use git to clone our 3 repositories:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
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
.ft P
.fi
.UNINDENT
.UNINDENT
.SS Configuring your Development Environment
.sp
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 \fI\%Daily PPA\fP\&. A PPA is an
unofficial Ubuntu repository, which has our software packages available to download and install.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
sudo add\-apt\-repository ppa:openshot.developers/libopenshot\-daily
sudo apt\-get update
sudo apt\-get install openshot\-qt \e
                     cmake \e
                     libx11\-dev \e
                     libasound2\-dev \e
                     libavcodec\-dev \e
                     libavdevice\-dev \e
                     libavfilter\-dev \e
                     libavformat\-dev \e
                     libavresample\-dev \e
                     libavutil\-dev \e
                     libfdk\-aac\-dev \e
                     libfreetype6\-dev \e
                     libjsoncpp\-dev \e
                     libmagick++\-dev \e
                     libopenshot\-audio\-dev \e
                     libswscale\-dev \e
                     libunittest++\-dev \e
                     libxcursor\-dev \e
                     libxinerama\-dev \e
                     libxrandr\-dev \e
                     libzmq3\-dev \e
                     pkg\-config \e
                     python3\-dev \e
                     qtbase5\-dev \e
                     qtmultimedia5\-dev \e
                     swig
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
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!
.SS libopenshot\-audio (Build Instructions)
.sp
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:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
cd libopenshot\-audio
mkdir build
cd build
cmake \-DCMAKE_INSTALL_PREFIX=dist ..
make
make install
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Essentially, we are switching to the \fBlibopenshot\-audio/build\fP folder,
then running \fBcmake ..\fP on the parent folder.
This finds dependencies and creates all the needed Makefiles used to compile this library.
Then \fBmake\fP uses those Makefiles to compile this library,
and \fBmake install\fP installs them in the location we specified.
If \fBCMAKE_INSTALL_PREFIX\fP isn’t set, the files will install to \fB/usr/local/\fP (by default) and \fBmake install\fP will require administrative privileges to run.
.SS libopenshot (Build Instructions)
.sp
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:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
cd libopenshot
mkdir build
cd build
cmake \-DLIBOPENSHOT_AUDIO_DIR=../../libopenshot\-audio/build/dist ..
make
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Essentially, we are switching to the \fBlibopenshot/build\fP folder,
then running \fBcmake ..\fP on the parent folder.
This finds dependencies and creates all the needed Makefiles used to compile this library.
Then \fBmake\fP uses those Makefiles to compile this library.
Because we provided the location of our compiled \fBlibopenshot\-audio\fP installation,
that version of the library will be used instead of the system version (if any).
.sp
We don’t install our \fBlibopenshot\fP after building, because we don’t need to.
For testing purposes, we can tell OpenShot to use \fBlibopenshot\fP right from our \fBbuild\fP directory.
.SS openshot\-qt (Launch Instructions)
.sp
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
\fBlibopenshot\-audio\fP and \fBlibopenshot\fP libraries, use the following commands:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
cd openshot\-qt
PYTHONPATH=../libopenshot/build/src/bindings/python
python3 src/launch.py
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
This should launch the OpenShot user interface.
Any changes you have made to the source code files
(\fB*.py\fP Python files, \fB*.ui\fP PyQt UI files, etc…) will be included.
This requires the \fBlibopenshot\-audio\fP and \fBlibopenshot\fP libraries,
and if anything went wrong with the steps above, OpenShot will likely not launch.
.sp
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!
.SS GitHub Issues
.sp
Now that you have successfully compiled and launched OpenShot Video Editor,
be sure to check out our list of bug reports on GitHub: \fI\%OpenShot Issues\fP\&.
Also, feel free to send me an email:
\fI\%jonathan@openshot.org\fP and introduce yourself!
I’m always here to help if you have any questions.
.SS Share your Changes
.sp
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 \fI\%Pull Request\fP\&.
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.
.SS Contributing
.SS Did you find a bug?
.INDENT 0.0
.IP \(bu 2
\fBPlease check if this bug was already reported\fP by searching on
GitHub under \fI\%Issues\fP\&.
.IP \(bu 2
If you’re unable to find an open issue addressing the problem,
\fI\%open a new one\fP\&.
Be sure to include a \fBtitle and clear description\fP, as much relevant
information as possible, and the steps to reproduce the crash or
issue.
.IP \(bu 2
Please \fBattach log files\fP if you are reporting a crash. Otherwise,
we will not be able to determine the cause of the crash.
.UNINDENT
.SS Please download our latest daily installer:
.INDENT 0.0
.IP 1. 3
\fI\%openshot.org/download\fP \- click the ‘\fBDAILY BUILDS\fP’ button, then grab the latest build from the list.
(Use the buttons below to download installers for a different Operating System.)
.IP 2. 3
Then enable ‘Debug Mode (Verbose)’ in the Preferences
.IP 3. 3
Quit OpenShot and delete both log files:
.INDENT 3.0
.IP \(bu 2
\fBWindows\fP: OpenShot stores its logs in your user profile
directory (\fB%USERPROFILE%\fP, e.g. \fBC:\eUsers\eusername\e\fP)
.INDENT 3.0
.IP \(bu 2
\fB%USERPROFILE%/.openshot_qt/openshot\-qt.log\fP
.IP \(bu 2
\fB%USERPROFILE%/.openshot_qt/libopenshot.log\fP
.UNINDENT
.IP \(bu 2
\fBLinux/MacOS\fP: OpenShot stores its logs in your home directory
(\fB$HOME\fP, e.g. \fB/home/username/\fP)
.INDENT 3.0
.IP \(bu 2
\fB$HOME/.openshot_qt/openshot\-qt.log\fP
.IP \(bu 2
\fB$HOME/.openshot_qt/libopenshot.log\fP
.UNINDENT
.UNINDENT
.IP 4. 3
Re\-launch OpenShot and trigger the crash as quickly as possible (to
keep the log files small)
.IP 5. 3
Attach \fBboth\fP log files
.UNINDENT
.SS Did you write a patch that fixes a bug?
.INDENT 0.0
.IP \(bu 2
Open a new GitHub pull request with the patch.
.IP \(bu 2
Ensure the PR description clearly describes the problem and solution.
Include the relevant issue number if applicable.
.IP \(bu 2
Before submitting, please ensure your PR passes all build /
compilation / and unit tests.
.UNINDENT
.sp
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!
.sp
Thanks!
.sp
OpenShot Team
.SS Learn More
.sp
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: \fI\%Issues\fP\&.
.SH AUTHOR
Jonathan Thomas
.SH COPYRIGHT
2008-2020 OpenShot Studios, LLC
.\" Generated by docutils manpage writer.
.