Audex: Difference between revisions

    From KDE UserBase Wiki
    (Marked this version for translation)
    Line 10: Line 10:
    Audex is an easy to use audio CD ripping application. In general usage of audex is self-explanatory. With the first start audex scans your system for common encoders and creates a common set of profiles automatically for you.
    Audex is an easy to use audio CD ripping application. In general usage of audex is self-explanatory. With the first start audex scans your system for common encoders and creates a common set of profiles automatically for you.


    <!--T:7-->
    __TOC__
    __TOC__


    == Features ==
    == Features == <!--T:8-->


    <!--T:9-->
    * Ripping with CDDA Paranoia.
    * Ripping with CDDA Paranoia.
    * Supports Ogg Vorbis, FLAC, MP3, WAV, AAC and custom commandline encoders.  
    * Supports Ogg Vorbis, FLAC, MP3, WAV, AAC and custom commandline encoders.  
    Line 26: Line 28:
    [[Image:Audex2.png|thumb|300px|center||Let Audex scan to find your codecs and show your options]]
    [[Image:Audex2.png|thumb|300px|center||Let Audex scan to find your codecs and show your options]]


    == Filename schemes ==
    == Filename schemes == <!--T:10-->


    <!--T:11-->
    A filename scheme defines the path and filename of the audio files being created by Audex. A simple scheme in Audex could look like this:
    A filename scheme defines the path and filename of the audio files being created by Audex. A simple scheme in Audex could look like this:


    <!--T:12-->
    {{Input|1=<nowiki>$artist/$title/$trackno - $ttile.$suffix</nowiki>}}
    {{Input|1=<nowiki>$artist/$title/$trackno - $ttile.$suffix</nowiki>}}


    <!--T:13-->
    If you rip an audio CD from the artist "Metallica" and the album name is "Metallica", the files will be stored in the folder /Metallica/Metallica within your base path you set in the general settings. If the folder does not exist, Audex will create it for you.
    If you rip an audio CD from the artist "Metallica" and the album name is "Metallica", the files will be stored in the folder /Metallica/Metallica within your base path you set in the general settings. If the folder does not exist, Audex will create it for you.
    In case of flac files your files will be named "1 - Enter Sandman.flac", "2 - Sad But True.flac", "3 - Holier Than You.flac"...
    In case of flac files your files will be named "1 - Enter Sandman.flac", "2 - Sad But True.flac", "3 - Holier Than You.flac"...


    <!--T:14-->
    This is a list of variables you can use to define your custom filename scheme:
    This is a list of variables you can use to define your custom filename scheme:


    <!--T:15-->
    {| class="wikitable"
    {| class="wikitable"
    |-
    |-
    Line 59: Line 66:




    <!--T:16-->
    {| class="wikitable"
    {| class="wikitable"
    |-
    |-
    Line 75: Line 83:




    <!--T:17-->
    So, in many cases this will satisfiy your needs. For more detailed file name schemes, variables can have parameters. E.g.:
    So, in many cases this will satisfiy your needs. For more detailed file name schemes, variables can have parameters. E.g.:


    <!--T:18-->
    {{Input|1=<nowiki>$artist/$title/${trackno length="2" fillchar="0"} - $ttile.$suffix</nowiki>}}
    {{Input|1=<nowiki>$artist/$title/${trackno length="2" fillchar="0"} - $ttile.$suffix</nowiki>}}


    <!--T:19-->
    As you might think, parameters in this example means, that the track numbers will be forced to a length of 2 digits and numbers less than 10 are filled up with "0". So in case of flac files the files will be named "01 - Enter Sandman.flac", "02 - Sad But True.flac", "03 - Holier Than You.flac"...
    As you might think, parameters in this example means, that the track numbers will be forced to a length of 2 digits and numbers less than 10 are filled up with "0". So in case of flac files the files will be named "01 - Enter Sandman.flac", "02 - Sad But True.flac", "03 - Holier Than You.flac"...


    <!--T:20-->
    There is also an option for this in the user interface, which overrides parameters in the variable.
    There is also an option for this in the user interface, which overrides parameters in the variable.


    <!--T:21-->
    Another useful parameters might me this:
    Another useful parameters might me this:


    <!--T:22-->
    {{Input|1=<nowiki>$artist/${title lowercase="true"}/$trackno - $ttile.$suffix
    {{Input|1=<nowiki>$artist/${title lowercase="true"}/$trackno - $ttile.$suffix
    $artist/${title uppercase="true"}/$trackno - $ttile.$suffix</nowiki>}}
    $artist/${title uppercase="true"}/$trackno - $ttile.$suffix</nowiki>}}


    <!--T:23-->
    Your title name will be upcased or lowercased.
    Your title name will be upcased or lowercased.


    <!--T:24-->
    This is interesting, too:
    This is interesting, too:


    <!--T:25-->
    {{Input|1=<nowiki>${artist uppercase="true" left="1"}/$artist/$title/$trackno - $ttile.$suffix</nowiki>}}
    {{Input|1=<nowiki>${artist uppercase="true" left="1"}/$artist/$title/$trackno - $ttile.$suffix</nowiki>}}


    <!--T:26-->
    The parameter "left" means, that only the number of characters chosen, you set. In this example only the first upcased letter of the artist name is chosen to create a folder. Sometimes people sort their artists in alphabetic order in folders A, B, C, D, E...
    The parameter "left" means, that only the number of characters chosen, you set. In this example only the first upcased letter of the artist name is chosen to create a folder. Sometimes people sort their artists in alphabetic order in folders A, B, C, D, E...


    <!--T:27-->
    Maybe this is useful:
    Maybe this is useful:


    <!--T:28-->
    {{Input|1=<nowiki>${artist replace_char_list="true" replace_char_list_from="@#$%*" replace_char_list_to="____+"}/$artist/$title/$trackno - $ttile.$suffix</nowiki>}}
    {{Input|1=<nowiki>${artist replace_char_list="true" replace_char_list_from="@#$%*" replace_char_list_to="____+"}/$artist/$title/$trackno - $ttile.$suffix</nowiki>}}


    <!--T:29-->
    Every character in the parameter "replace_char_list_from" will be replaced by the character in the parameter "replace_char_list_to". E.g. "*" is replaced by "+". Of course these two strings must be equal size.  
    Every character in the parameter "replace_char_list_from" will be replaced by the character in the parameter "replace_char_list_to". E.g. "*" is replaced by "+". Of course these two strings must be equal size.  


    <!--T:30-->
    And last, take a look at this:
    And last, take a look at this:


    <!--T:31-->
    {{Input|1=<nowiki>${artist underscores="true"}_-_${title underscores="true"}/$trackno_-_$ttile.$suffix
    {{Input|1=<nowiki>${artist underscores="true"}_-_${title underscores="true"}/$trackno_-_$ttile.$suffix
    $artist/$title/$trackno_-_${ttile fat32compatible="true"}.$suffix</nowiki>}}
    $artist/$title/$trackno_-_${ttile fat32compatible="true"}.$suffix</nowiki>}}


    <!--T:32-->
    Sometimes people don't like spaces in their filenames (mainly for historical reasons I think). If you set underscores as true within a variable parameter all spaces will be replaced by underscores "_". The parameter "fat32compatible" will remove all FAT32 incompatible characters (like "?").
    Sometimes people don't like spaces in their filenames (mainly for historical reasons I think). If you set underscores as true within a variable parameter all spaces will be replaced by underscores "_". The parameter "fat32compatible" will remove all FAT32 incompatible characters (like "?").
    Normally you won't use these two parameters, as there are options in the user interface for the complete filename.  
    Normally you won't use these two parameters, as there are options in the user interface for the complete filename.  


    <!--T:33-->
    Here is a complete overview of filename scheme variables and their possible parameters:
    Here is a complete overview of filename scheme variables and their possible parameters:


    <!--T:34-->
    {| class="wikitable"
    {| class="wikitable"
    |-
    |-
    Line 145: Line 171:




    <!--T:35-->
    {| class="wikitable"
    {| class="wikitable"
    |-
    |-

    Revision as of 17:18, 14 April 2015

    Audex: Rip your audio CDs

    Audex is an easy to use audio CD ripping application. In general usage of audex is self-explanatory. With the first start audex scans your system for common encoders and creates a common set of profiles automatically for you.

    Features

    • Ripping with CDDA Paranoia.
    • Supports Ogg Vorbis, FLAC, MP3, WAV, AAC and custom commandline encoders.
    • Extensive filename schemes (see chapter filename schemes).
    • Metadata correction tools (like capitalization).
    • Profile based ripping.
    • Retrieve covers from the internet.
    • Create playlists, covers and template based info files.
    • Transfer files with KDE KIO-Slaves.
    Let Audex scan to find your codecs and show your options

    Filename schemes

    A filename scheme defines the path and filename of the audio files being created by Audex. A simple scheme in Audex could look like this:

    $artist/$title/$trackno - $ttile.$suffix

    If you rip an audio CD from the artist "Metallica" and the album name is "Metallica", the files will be stored in the folder /Metallica/Metallica within your base path you set in the general settings. If the folder does not exist, Audex will create it for you. In case of flac files your files will be named "1 - Enter Sandman.flac", "2 - Sad But True.flac", "3 - Holier Than You.flac"...

    This is a list of variables you can use to define your custom filename scheme:

    Variable Value
    $artist The artist of the CD. If your CD is a compilation, then this tag represents the title in most cases.
    $title The title of the CD. If your CD is a compilation, then this tag represents the subtitle in most cases.
    $date The release date of the CD. In almost all cases this is the year.
    $genre The genre of the CD.
    $cdno The CD number of a multi-CD album. Often compilations consist of several CDs. Note: If the multi-CD flag is not set for the current CD, than this value will be just empty.


    Variable Value
    $tartist This is the artist of every individual track. It is especially useful on compilation CDs.
    $ttitle The track title. Normally each track on a CD has its own title, which is the name of the song.
    $trackno The track number. First track is 1.


    So, in many cases this will satisfiy your needs. For more detailed file name schemes, variables can have parameters. E.g.:

    $artist/$title/${trackno length="2" fillchar="0"} - $ttile.$suffix

    As you might think, parameters in this example means, that the track numbers will be forced to a length of 2 digits and numbers less than 10 are filled up with "0". So in case of flac files the files will be named "01 - Enter Sandman.flac", "02 - Sad But True.flac", "03 - Holier Than You.flac"...

    There is also an option for this in the user interface, which overrides parameters in the variable.

    Another useful parameters might me this:

    $artist/${title lowercase="true"}/$trackno - $ttile.$suffix
    $artist/${title uppercase="true"}/$trackno - $ttile.$suffix

    Your title name will be upcased or lowercased.

    This is interesting, too:

    ${artist uppercase="true" left="1"}/$artist/$title/$trackno - $ttile.$suffix

    The parameter "left" means, that only the number of characters chosen, you set. In this example only the first upcased letter of the artist name is chosen to create a folder. Sometimes people sort their artists in alphabetic order in folders A, B, C, D, E...

    Maybe this is useful:

    ${artist replace_char_list="true" replace_char_list_from="@#$%*" replace_char_list_to="____+"}/$artist/$title/$trackno - $ttile.$suffix

    Every character in the parameter "replace_char_list_from" will be replaced by the character in the parameter "replace_char_list_to". E.g. "*" is replaced by "+". Of course these two strings must be equal size.

    And last, take a look at this:

    ${artist underscores="true"}_-_${title underscores="true"}/$trackno_-_$ttile.$suffix
    $artist/$title/$trackno_-_${ttile fat32compatible="true"}.$suffix

    Sometimes people don't like spaces in their filenames (mainly for historical reasons I think). If you set underscores as true within a variable parameter all spaces will be replaced by underscores "_". The parameter "fat32compatible" will remove all FAT32 incompatible characters (like "?"). Normally you won't use these two parameters, as there are options in the user interface for the complete filename.

    Here is a complete overview of filename scheme variables and their possible parameters:

    Variable Value Parameters
    $artist The artist of the CD. If your CD is a compilation, then this tag represents the title in most cases. left, lowercase, uppercase, replace_char_list, replace_char_list_from, replace_char_list_to, underscores, fat32compatible
    $title The title of the CD. If your CD is a compilation, then this tag represents the subtitle in most cases. left, lowercase, uppercase, replace_char_list, replace_char_list_from, replace_char_list_to, underscores, fat32compatible
    $date The release date of the CD. In almost all cases this is the year. left, lowercase, uppercase, replace_char_list, replace_char_list_from, replace_char_list_to, underscores, fat32compatible
    $genre The genre of the CD. left, lowercase, uppercase, replace_char_list, replace_char_list_from, replace_char_list_to, underscores, fat32compatible
    $cdno The CD number of a multi-CD album. Often compilations consist of several CDs. Note: If the multi-CD flag is not set for the current CD, than this value will be just empty.
    $suffix The filename extension (e.g. .ogg, .mp3), normally based on your encoder.


    Variable Value Parameters
    $tartist This is the artist of every individual track. It is especially useful on compilation CDs. left, lowercase, uppercase, replace_char_list, replace_char_list_from, replace_char_list_to, underscores, fat32compatible
    $ttitle The track title. Normally each track on a CD has its own title, which is the name of the song. left, lowercase, uppercase, replace_char_list, replace_char_list_from, replace_char_list_to, underscores, fat32compatible
    $trackno The track number. First track is 1. length, fillchar

    Links



    Support for this application can obtained by asking questions on the application's Discussion page