xHE-Opus/readme.md

# xHE-Opus
xHE-Opus is extended High Efficiency. It use Dual-Encoder to encode per channel and bitrate is divide 2 for per channel.
It provides optimal coding efficiency with bitrates from 6 to 510 kilobits per second and above.
It has content loudness metadata on footer.

# Demo
https://github.com/damp11113/xHE-Opus/assets/64675096/5792f6b4-4ffd-4995-a1ad-97d245b1d1a2

# Install
[PyOgg (damp11113 moded)](https://github.com/damp11113/PyOgg)

# Using
## Encoder
to encode you can use
```bash
$ python3 encode.py
```
```bash
usage: encode.py [-h] [-sr SAMPRATE] [-b BITRATE] [-c COMPRESS] [-l LOSS] [-fs FRAMESIZE] [-bm BITMODE]
                 [-bw BANDWIDTH] [-a APP] [-v VER] [-pred] [-ph] [-dtx] [-sb]
                 input output
encode.py: error: the following arguments are required: input, output
```
simple example
```bash
$ python3 encode.py input.wav output.xopus
```
This will convert to xhe-opus with bitrate 64Kbps (32Kbps per channel), bitrate mode is CVBR, compression is 10 and app is hev2

or if you want to set bitrate you can use `-b <bitrate>` input bit per sec (bps) like
```bash
$ python3 encode.py input.wav output.xopus -b 16000
```

## Decoder/Player
To player or decode this file you can use
```bash
$ python3 player.py input.xopus
```
or if you want only convert to wav you can use
```bash
$ python3 player.py input.xopus -o output.wav
```