ks-mp3 - Convert video/audio file(s) to MP3 (Audio) Format.
===========================================================

### Syntax:

  * `$ ks-mp3 </absolute/path/song.ogg> </path/prefix_name>`

### Default configuration:

  * The script `ks-mp3` use by default the following configuration:
  
    * `- Audio codec: libmp3lame`
    * `- Bitrate audio: 128k`
    * `- Container: mp3`
    
  * If you want to change the settings, you need to edit the `ks-mp3` file and change the following variables:

    * `# Basic parameters`
    * `acodec="libmp3lame"`
    * `b_acodec="128k"`
    * `v_ext="mp3"`
    * `default_lang_audio="spa"`
    
### Example of use:

  * An example of use would be the following:
  
    * `$ ks-mp3 /data/video/Example.mkv /data/audio/Example`
    
  * 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:

    * `* 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 MP3 Audio`
    * `  ffmpeg -i "Example.mkv" -map 0:1 -c:a libmp3lame -b:a 128k -metadata title="My song" -metadata date="2016" -metadata genre="Rap" -metadata album="My personal album" -metadata artist="q3aql" -metadata track="2" "Example.mp3"`
    * `.`
    * `* (Default: y) Do you want run the conversion? (y/n): n`
    
### Back to README.md
    
* [Go back](https://github.com/q3aql/ks-tools/blob/main/README.md)
  
