ks-tools/doc/ks-oga.md

74 lines
2.0 KiB
Markdown
Raw Normal View History

2022-01-25 20:21:47 +01:00
ks-oga - Convert video/audio file to OGA (OGG Audio) Format.
============================================================
2021-03-07 21:24:26 +01:00
2021-03-22 18:43:19 +01:00
### Syntax:
2021-03-07 21:24:26 +01:00
2021-04-18 00:21:59 +02:00
```shell
$ ks-oga </absolute/path/song.mp3> </path/prefix_name>
```
2021-03-07 21:24:26 +01:00
### Default configuration:
* The script `ks-oga` use by default the following configuration:
2021-04-18 00:21:59 +02:00
```shell
- Audio codec: libvorbis
- Bitrate audio: 130k
- Container: oga
````
2021-03-07 21:24:26 +01:00
2022-01-02 12:25:43 +01:00
* If you want to change the settings, you need to edit the `~/.ks-tools/ks-oga` file and change the following variables:
2021-03-07 21:24:26 +01:00
2021-04-18 00:21:59 +02:00
```shell
acodec="libvorbis"
b_acodec="130k"
v_ext="oga"
default_lang_audio="spa"
````
2022-01-02 16:47:57 +01:00
* RECOMMENDED: You can use the [ks-conf](https://github.com/q3aql/ks-tools/blob/main/doc/ks-conf.md) tool to edit the configuration.
2021-03-07 21:24:26 +01:00
### Example of use:
* An example of use would be the following:
2021-04-18 00:21:59 +02:00
```shell
$ ks-oga /data/video/Example.mkv /data/audio/Example
````
2021-03-07 21:24:26 +01:00
* Executing the command, the file will be analyzed and a wizard will be shown to select the tracks, choose the settings and define the metadata:
2021-04-18 00:21:59 +02:00
```shell
* Information of Example.mkv:
+ Audio Tracks:
Stream #0:1(spa): Audio: ac3
Stream #0:2(eng): Audio: ac3
* (Default: 0:1) Type the number of audio track:
* METADATA configuration:
* (Default: Example) Type name of title: My song
* (Default: Album-Disc) Type name of album: My personal album
* (Default: 01) Type number of track: 2
* (Default: Artist) Type name of artist: q3aql
* (Default: 2021) Type the year: 2016
* (Default: Pop) Type the genre: Rap
* COMMANDS THAT WILL BE EXECUTED:
# Convert the file 'Example.mkv' to OGG Audio
ffmpeg -i "Example.mkv" -map 0:1 -c:a libvorbis -b:a 130k
-metadata title="My song" -metadata date="2016"
-metadata genre="Rap" -metadata album="My personal album"
-metadata artist="q3aql" -metadata track="2" "Example.oga"
* (Default: y) Do you want run the conversion? (y/n): n
````
2021-03-07 21:24:26 +01:00
### Back to README.md
2022-03-26 14:53:14 +01:00
* [Go back](../README.md)
2021-03-22 18:43:19 +01:00