media-tools/README.md

# to_opus
converting 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.
See https://wiki.xiph.org/Opus_Recommended_Settings for more information about this.

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

### Examples

convert all files with .mp3-extension and .flac-extension to opus
```bash to_opus.sh -e mp3 -e flac```

convert all files to opus
```bash to_opus.sh -e "*"```

convert the audiostream of an movie
```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)