https://github.com/DonCanjas/mpv-webp-generator

Creates high quality animated webp images using mpv hotkeys
https://github.com/DonCanjas/mpv-webp-generator

Last synced: 3 days ago
JSON representation

Creates high quality animated webp images using mpv hotkeys

• Host: GitHub
• URL: https://github.com/DonCanjas/mpv-webp-generator
• Owner: DonCanjas
• Created: 2021-03-26T10:42:07.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-04-28T15:20:43.000Z (about 2 years ago)
• Last Synced: 2024-03-09T14:31:46.211Z (4 months ago)
• Language: Lua
• Homepage:
• Size: 34.2 KB
• Stars: 10
• Watchers: 1
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Lists

• awesome-mpv - webp-generator - Creates animated webp using mpv hotkeys. (Windows only) (Image)
• stars - DonCanjas/mpv-webp-generator - Creates high quality animated webp images using mpv hotkeys (Lua)

README

        
# mpv-webp-generator *for windows*

Creates high quality animated webp using mpv hotkeys

![Fruits Basket Season 2](https://files.catbox.moe/rt0czz.webp)

Based on [Scheliux](https://github.com/Scheliux/)'s [gif generator](https://gist.github.com/Ruin0x11/8fae0a9341b41015935f76f913b28d2a) port to windows, which you cand find [here](https://github.com/Scheliux/mpv-gif-generator).

Thanks to July who helped me with ffmpeg's parameters.

# Requirements 

- Windows

- mpv

- ffmpeg

# Installation

First of all, you must make sure `ffmpeg` is in your `%PATH%` and accesible via your command line. After ensuring this, clone or download as zip. Then, head to `%APPDATA%/mpv/scripts` and place `mpv-webp.lua` in there; if neither `%APPDATA%/mpv` nor `%APPDATA%/mpv/scripts` exist, you will have to create them. It's as easy as that!

[How to install ffmpeg](https://www.wikihow.com/Install-FFmpeg-on-Windows)

# Configuration

*Note this is still in progress and might not work properly*

The three options the script offers (at least for now) are:

* `dir` – Sets the output directory. Default is `C:\Users\%USERNAME%\Desktop\`.

* `rez` – Sets the resolution of the output webp. Default is 600 width.

* `fps` – Sets the framerate of the output webp. Default is 15. Don't go too overboard or the filesize will balloon.

# webp settings

* `qscale` - set as 90 out of 100. It will determine the quality of the webp. Not recommended to go lower than 85. 

* `lossless` - set as 0 by default (lossy), change to 1 for lossless. When doing a lossless export, `qscale` will no longer determine the quality, but the encoding eficiency.

* `compression_level` - set as 6 out of 6. The process might take a while, so if you don't want to wait, you should lower it, but the lower the value, the bigger the filesize.

## Usage

You can use `,` and `.` to rewind or foward one frame at a time in order to select the desired starting and ending frames of the webp. You only need to define the start and ending times and to choose if exporting with or without subtitles. In order to do that, you can use the following hotkeys: 

* `w` - Start time

* `W` - End time

* `CTRL+w` - Export webp

* `CTRL+W` - Export webp with subtitles  - *only works with srt*

## Stuff to do

If you wish to contribute, here are some suggestions:

* Remake the section that handles hardsubbing to support not only srt, but also ass/ssa while keeping its styles.

* Add support for a config file to customize not only webp's settings, but also keybindings and output directory. (at least I can't make it work on my pc)

* Add automatic crop to crop black borders out of video without interfering with DAR. User must be able to enable and disable this feature via .conf file.