media-tools/to_vp9/README.md

# to_vp9
**This Script is unfinished and not ready for usage.**

This script converts all videostreams in all files with given file extension in your current working directory and all subdirectories to vp9 using the Matroska container.

The standard settings are in my opinion good for personal storage of movies. Feel free to change them or suggest changes. Later there will be options in the script to change the default behavior.

If used on containers with subtitles or audiostreams, this skript will only convert the videostream and copy the other streams.

## Flags
```-e``` defines the extension of the files that should be converted<br>
```-d``` deletes original files after conversion (not implemented)<br>
```-h``` show help (not implemented)

## Examples

convert all videostreams in all files to vp9<br>
```bash to_vp9.sh -e "*"```

convert the videostream of an movie<br>
```bash to_opus.sh -e mp4```

## Dependencies
- ffmpeg
- Bash 4^

## Encoders

### libvpx-vp9
Needs a ffmpeg built with ```--enable-libvpx```
- https://trac.ffmpeg.org/wiki/Encode/VP9
- https://ffmpeg.org/ffmpeg-codecs.html#libvpx

### VP9_vaapi

needs libva and [Hardware video acceleration](https://wiki.archlinux.org/title/Hardware_video_acceleration) available in your system. Try vainfo in your terminal for verification.
- https://ffmpeg.org/ffmpeg-all.html#VAAPI-encoders
- https://trac.ffmpeg.org/wiki/Hardware/VAAPI

### VP9_qsv

needs [Hardware video acceleration](https://wiki.archlinux.org/title/Hardware_video_acceleration) with QuickSync and ffmpeg-build with ```--enable-libmfx``` or ```--enable-libvpl```.
- [Differences between libvpl and libmfx](https://www.intel.com/content/www/us/en/developer/articles/technical/onevpl-in-ffmpeg-for-great-streaming-on-intel-gpus.html)
- https://ffmpeg.org/ffmpeg-all.html#QSV-Encoders
- https://trac.ffmpeg.org/wiki/Hardware/QuickSync
- https://www.intel.com/content/www/us/en/developer/articles/technical/common-bitrate-control-methods-in-intel-media-sdk.html
- https://www.intel.com/content/www/us/en/developer/articles/technical/advanced-bitrate-control-methods-in-intel-media-sdk.html