media-tools/to_opus/README.md

# to_opus
This script converts all audiostreams in all files with given file extension in your current working directory and all subdirectories to opus.
The Script will choose an automatic bitrate for every audiostream dependent on the number of channels and the original bitrate.[[1]](https://wiki.xiph.org/Opus_Recommended_Settings)

If used on containers with video- or multiple audiostreams, this skript will only convert the audiostream and copy all streams in a Matroska container.

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

## Examples

convert all files in your current working directory and all subdirectorys<br>
```bash to_opus.sh -e "*"```

convert all files with .mp3-extension and .flac-extension to opus and deletes original files after that<br>
```bash to_opus.sh -e mp3 -e flac -d```

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

## Dependencies
- ffmpeg
- Bash 4^

## Why opus? 

Opus is an open format and royalty free. It is FOSS.
It is supported on most platforms and has a better quality per bitrate then formats like mp3 or Vorbis.

![Opus Quality comparison with other formats](https://upload.wikimedia.org/wikipedia/commons/0/01/Opus_quality_comparison.svg)