forked from OpenShot/openshot-qt
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
165 lines (106 loc) · 5.24 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
#################
COPYRIGHT
#################
Copyright (c) 2008-2014 OpenShot Studios, LLC
(http://www.openshotstudios.com). This file is part of
OpenShot Video Editor (http://www.openshot.org), an open-source project
dedicated to delivering high quality video editing and animation solutions
to the world.
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.
OpenShot Video Editor is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with OpenShot Library. If not, see <http://www.gnu.org/licenses/>.
#################
INSTRUCTIONS
#################
OpenShot Video Editor 2.0 supports Linux, Mac, and Windows. But due to
the many dependencies required to run OpenShot, we recommend using an
installer for your operating system. Please visit
http://www.openshot.org/download/ to find your correct installer.
#################
DOCUMENTATION
#################
Documenation for OpenShot 2.0 can be generated with Doxygen, a popular
command-line application for scanning source code and generating readable
documention. OpenShot contains a Doxygen input file (Doxyfile.in), but
you must first install the following Python filter for Doxygen: doxypy.
Then, run the following command:
$ doxygen Doxyfile.in
#################
DEPENDENCIES
#################
Although installers are much easier to use, if you must build from
source, here are some tips:
OpenShot 2.0 is programmed in Python, and thus does not need
to be compiled to run. However, be sure you have the following
dependencies in order to run OpenShot successfully:
1) Python 3.0+ (http://www.python.org)
2) PyQt5 (http://www.riverbankcomputing.co.uk/software/pyqt/download5)
3) libopenshot: OpenShot Library (http://www.openshot.org)
4) FFmpeg or Libav (http://www.ffmpeg.org/ or http://libav.org/)
5) GCC build tools (or MinGW on Windows)
To run OpenShot from the command line, use the following syntax:
(be sure the change the path to match the install location of OpenShot)
$ cd /home/USER/openshot/src
$ ./openshot or $ python openshot.py
#################
HOW TO INSTALL
#################
If you would like to install OpenShot, use this command:
$ sudo python setup.py install
Installing OpenShot using this command does a few extra things that
the build wizard doesn't do. It adds MIME Types, adds an icon to your
Application menu, registers icons, adds a /usr/bin/openshot command, and
copies all the code files to the /site-packages/ folder.
#################
TUTORIAL
#################
Here is a tutorial of the current development features:
DO YOU HAVE A HELP MANUAL?
1) Yes, go to http://www.openshotusers.com/help/en/
HOW DO I ADD MEDIA TO MY VIDEO PROJECT?
1) Drag and drop videos or music files from gnome into the "Project Files" tree.
2) Click the File / Import Files... menu
3) Click the "Import Files" icon on the toolbar (at the top of the screen)
HOW DO I ADD MEDIA TO MY TIMELINE
1) Click on any file in your "Project Files" tree, and drag it onto the timeline (at the bottom of the screen)
HOW DO I POSITION CLIPS ON THE TIMELINE
1) Simply click on any clips already on the timeline, and drag them to their new location
2) Use the magnet icon to have your clips magically stick to their closest neighbor clips.
HOW DO I TRIM / UN-TRIM CLIPS
1) Use the toolbar above the timeline (i.e. in the middle of the screen) and select the TRIM button
2) Then, move your mouse over the edges of any clips. Click and drag the edge of the clip to it's new location.
THE AUDIO / VIDEO IS OUT OF SYNC. WHAT CAN I DO?
1) This is usually related to a bug in libopenshot or FFmpeg. To resolve this, re-encode the video using the
ffmpeg command line tool.
2) Here is an example command to convert a folder full of Canon MTS files to MP4:
$ find '/home/jonathan/Desktop/Caveman Movie/Videos' -iname "*.MTS" -exec ffmpeg -i {} -acodec libfaac -ab 128k -ac 2 -r 60 -vcodec mpeg4 -f mp4 -y -sameq {}.mp4 \;
3) Usually the reason the A/V are out of sync is related to the frame rate (i.e. the -r parameter on the ffmpeg command).
Try a variety of frame rates and OpenShot project types to find one that doesn't have A/V sync issues.
Some common rates are: -r 29.97 -r 25 -r 30 -r 60
#################
WEBSITES
#################
http://www.openshot.org/ (PROJECT WEBSITE and BLOG)
http://launchpad.net/openshot/ (SOURCE CODE, BUG TRACKER, TRANSLATIONS)
http://freshmeat.net/projects/openshot-video-editor/
https://sourceforge.net/projects/openshotvideo/
https://www.ohloh.net/p/openshot-video-editor/
####################
REPORT A BUG
####################
https://bugs.launchpad.net/openshot
####################
TRANSLATIONS
####################
https://translations.launchpad.net/openshot
####################
ASK A QUESTION
####################
https://answers.launchpad.net/openshot