The $ symbol that you in commands should not actually be included when you type a command in or copy-paste it to your command-line. Their purpose is to:
- Signify that this command should be run on a command-line.
- Signify that this command is a complete version that you can run, unlike fragments that are meant to demonstrate a specific argument.
Create an edited version of example.mp4 with the default parameters.
$ python auto-editor.py example.mp4
You can change how much space (frames) their is between each cut by specifying the frame margin. The frame margin is how much frames there are on each side between the loud parts.
$ python auto-editor.py example.mp4 --frame_margin 1
| Command | --frame_margin |
|---|---|
| type | int |
| range | 0 to Infinity |
| default | 4 |
| short | -m |
Video speed will change speed of the output's video and audio. For instance, if the speed is set to 2. Half of the frames will be dropped and the audio will be speed up. This does not affect parts of the video that are below the silent threshold.
$ python auto-editor.py example.mp4 --video_speed 2
| Command | --video_speed |
|---|---|
| type | float |
| range | 0 to 99999 |
| default | 1 |
| short | -v |
| alias | --sounded_speed |
You can also do the same, but for the silent parts with --silent_speed
$ python auto-editor.py example.mp4 --video_speed 2 --silent_speed 8
| Command | --silent_speed |
|---|---|
| type | float |
| range | 0 to 99999 |
| default | 99999 |
| short | -s |
You can tell auto-editor to zoom in when the input's audio is above the loudness threshold. Auto-Editor will hold the zoom until there's a cut.
--loudness_threshold
| Command | --loudness_threshold |
|---|---|
| type | float |
| range | 0 to 1 |
| default | 2 |
| short | -l |
Here is a side by side comparison between a video with no zoom, and a video with auto zoom.
(video source from jacksfilms)
auto-editor.py input
Input is the only required argument for auto-editor. It supports video formats, audio formats, and URLs. For certain commands that do simple things, such as --clear_cache or --version, it's okay to skip providing an input.
Here an example of using a url as the input for auto-editor. You should always wrap the url around single quotes or double quotes.
$ python auto-editor.py "https://www.youtube.com/watch?v=kcs82HnguGc"
You can add background music to your video automatically.
$ python auto-editor.py example.mp4 --background_music media/Magic_in_the_Garden.mp3
It will be quiet than the video's audio by 10dB and will fade out at the last second of the video.
You can add an audio track to your video that will replace the video's audio as the one to base cuts on.
$ python auto-editor.py example.mp4 --cut_by_this_audio media/newCommentary.mp3
This option is good for combining gameplay videos with commentary, but beware that it doesn't change the volume for either audio unlike --background_music.
Video files can contain more than audio file and auto-editor. These 'audio files' are what we call audio tracks and auto-editor has a set of tools to deal with these tracks. First, if you'll like the tracks be separated on the output, use the flag --keep_tracks_seperate
$ python auto-editor.py videoWith2Tracks.mp4 --keep_tracks_seperate
Auto-Editor works by cutting out the silent parts and it needs to choose which audio track to base cuts on. By default it will be set to 0 (the first track) but you can change that with the --cut_by_this_track command.
$ python auto-editor.py videoWith2Tracks.mp4 --cut_by_this_track 1
Now the video with be cut by second audio track's volume! But what if you wanted to just ignore tracks all together? Well, with the --cut_by_all_tracks command, auto-editor will act is if all tracks were muxed into a single one.
$ python auto-editor.py videoWith2Tracks.mp4 --cut_by_all_tracks
Some videos need to be converted to a jpeg image sequence before hand but this can take awhile. What if you want to use the same video but use different parameters. That's where caching comes in. The jpeg sequence and the audio are stored away in the .CACHE folder, ready to be used again if it is right.
The .CACHE folder can take quiet a bit of space so if you want to delete the folder and all its contents, run this command.
$ python auto-editor.py --clear_cache
Or, you can clear the cache before making a new one.
$ python auto-editor.py example.mp4 --clear_cache
If you'll like to only make a cache folder to be used for later, run this.
$ python auto-editor.py example.mp4 --prerun
Get the list of commands generated by argparse.
$ python auto-editor.py --help
Get the version of auto-editor you're using.
$ python auto-editor.py --version
Get debug information regarding auto-editor, including your python version, whether the your python is 64-bit or not, and the current version.
$ python auto-editor.py --debug