ks-tools/doc/ks-mp3.md

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-tools/ks-mp3 file and change the following variables:

  acodec="libmp3lame"
  b_acodec="128k"
  v_ext="mp3"
  default_lang_audio="spa"
  

• RECOMMENDED: You can use the ks-conf tool to edit the configuration.

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