Writes a list of "edits" made to the current video file to a file in your current working directory. Edits can be used later as params for ffmpeg, for bulk video cropping, resizing, etc.
As you're watching your video, you may crop, flip, delogo, and set loop start and end times. Once you have the video how you want it, press your selected keybinding, and the changes will be written to the file you configured, in a JSON-LD formatted file.
Getting the edits into ffmpeg is trivial, an example fish shell script for doing so is included, at bulkedit.fish. It has some convenience utilities around MacOS issues as well; I recommend you have gdate and gtouch installed, as the BSD versions Apple includes lack many features. You can install them with brew install coreutils.
An edit file is a fairly simple JSON document, the keys are standardized across each line, and so should be relatively self documenting. Fields are always present, if they are unused they are encoded to null.
An example such line is below, formatted for readability:
{
"end": 12.084,
"filters": [
"crop=x=468:y=300:w=297:h=175",
"hflip"
],
"newFilename": null,
"path": "video.mp4",
"start": 1.204
}The following filters and "edits" are extracted:
- crop: Any video crops, and any number of video crops. Supports both regular
cropandlavif-crop - delogo: Same as crop, any number of delogos are supported.
- loop start, loop end: Sets edit start and end times. Useful for cropping out intros, outros, etc.
- flip: Both
hflipandvflipare supported. - rotation: Supports video rotations, BUT only in 90º increments. Outputs as
transposeorhflip,vflipfilters.
Note that filters are stored in the editlist in the order MPV keeps them internally. Generally this is the order in which you apply them, but not always.
shift+Alt+c script-message-to writeedits write_edits
No default keybindings are provided. Replace "edits" with the name of the file you want to write to.
You may specify the filename to write edits to in two ways (the default filename is edits):
- Add the following to your
mpv.confor profile configuration:writeedits-filename = "yourfilename" - Add the filename to your input conf binding:
shift+Alt+c script-message-to writeedits write_edits "edits"
I recommend adding the following to your input.conf, for ease in applying filters/edits for use with this script:
# Rotate video
Meta+r cycle-values video-rotate "90" "180" "270" "0"
Meta+Alt+r cycle-values video-rotate "270" "180" "90" "0"
Meta+Shift+r set video-rotate "0"
# Flip video
h vf toggle hflip
v vf toggle vflip
# Remove previous filter
d vf del -1
# Clear filters and rotations
D vf clr ""; set video-rotate "0"
# show current filterchain
shift+i print-text "${vf}"
Additionally, the following scripts are useful in conjunction with this one:
- autocrop Automatically crop black boxes off the sides of your video.
- crop Lets you visually crop the video, recursively. Also supports delogo.
- skipscene Skips to the beginning of the next scene.
- live-filters Allows real time editing of applied filters. Note the list of supported filters above.