Audex

What is Audex?

Audex is an audio grabber tool for CD-ROM drives for the KDE SC 4 desktop environment.

Audex creates profiles for LAME, Ogg Vorbis (oggenc), FLAC, MP4/M4A/AAC (faac) and RIFF WAVE. Please install your favorite encoder. For WAVE no external encoder is needed. Beyond you can define custom profile, which means, that Audex works together with commmand line encoders in general.

You can define filename schemes. Please take a look at the documentation on this webpage to see what's possible.

Features

Plans

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

News

2014-11-16

Release of Audex 0.79.
This is only a bugfix release.

2014-02-22

Release of Audex 0.78.
Audex is still there: Fixed google cover search and embed cover in FLAC files. As in every release there are also minor bugfixes...

2013-02-01

Release of Audex 0.77 beta 1.
Integrated new playlist module (relative filenames in playlists and playlist merging). Also minor bugfixes...

2013-01-27

Audex is now on git://anongit.kde.org/audex. Goodbye Subversion.

2013-01-22

Release of Audex 0.76 beta 2.
Cue sheet writer fix and some minor code fixes.

2013-01-20

Release of Audex 0.76 beta 1.
Mainly integration of some patches and some new variables in the template engine.

2011-01-15

Release of Audex 0.74 beta 1.
I've backported single file rip/cue sheet support from Audex 0.8. Please note, that this support is still limited.

2011-01-06

Audex is still alive: Release of Audex 0.73 beta 1.
Thanks to Craig Drummond for many patches!
And Audex is still on the way. I've resumed my work on 0.80, I'm working just on CUE-Sheet implementation.

2010-03-03

I'm very very sorry, but some important things got in the way. But developing continues, although much slower than expected.
So when to expect Audex 0.80? I don't know, but I think this month. Critical parts of Audex still working, although untested.

2010-01-07

I have much to do at the moment. But I'm looking forward to publish first working version of Audex 0.80 end january.

2009-10-29

Audex is now hosted at KDE SVN.

2009-09-11

Release of Audex 0.72 beta 1.

2009-06-26

Release of Audex 0.71 beta 5.

2009-06-25

Release of Audex 0.71 beta 4.

2009-06-12

New Forum is open.
Feel free to post :- )

2009-06-08

Release of Audex 0.71 beta 3.

2009-05-16

Release of Audex 0.71 beta 2.

2009-05-12

Release of Audex 0.71 beta.

2009-04-12

Release of Audex 0.70 beta.
You are welcome to translate Audex to your own language. I'm looking forward to publish Audex 0.71 or even 0.70 beta2 supporting as many languages as possible.

2009-03-30

Good news!
I'm going to release Audex 0.70 beta for beta testers 2009-04-02 and public beta for everyone 2009-04-12. Bugfixes and improvements:

If you want to be a beta tester, you should be able to compile Audex from source. Send me an email with your distribution and you will get the sources. Please report bugs, errors etc.

2009-01-11

Happy new year!
Audex 0.62 available! Bugfixes and improvements:

2008-12-28

So far so good!
Audex 0.61 is on the road! Many bugfixes and improvements all over the program.

2008-12-22

Merry Christmas!
Just relaunched website. Unfortunately I've lost my old news.
Anyhow... I hope, I'll be able to release version 0.61 BETA of Audex this year.

Screenshots


Main window

Edit data

The configuration dialog

Create profiles

The extraction dialog

Downloads

IMPORTANT NOTE: CDDB/FreeDB submit will work as soon as kdemultimedia libs are patched.
NOTE: As LAME still can't handle unicode characters correct, Audex uses since version 0.73 eyeD3 for tagging mp3 files, if available. It is highly recommended to install eye3D on your system if you create mp3 files with Audex!

What you need

To run (and compile) Audex you need:

Sources

D/L audex-0.79.tar.xz (source, MD5: f7dea212961b90c83d061b0e0ca897c2)
D/L audex-0.78.tar.xz (source, MD5: e424309ab085de40043f841f2fa230c6)
D/L audex-0.77b1.tar.xz (source, MD5: 1f3df64b60b15315e958e3e3b151fe92)
D/L audex-0.76b2.tar.xz (source, MD5: c971bbfa113e4d54b0dcaae8afbf70fb)
D/L audex-0.76b1.tar.xz (source, MD5: 4761c6c47fb3da0b89713f542c8dcf2f)
D/L audex-0.74b1.tar.xz (source)
D/L audex-0.73b1.tar.xz (source)
D/L audex-0.72b1.tar.xz (source)
D/L audex-0.71b5.tar.xz (source)
D/L audex-0.71b4.tar.xz (source)
D/L audex-0.71b3.tar.xz (source)
D/L audex-0.71b2.tar.xz (source)
D/L audex-0.71b1.tar.xz (source)
D/L audex-0.70b1.tar.xz (source)
D/L audex-0.62b.tar.xz (source)
D/L audex-0.61b.tar.xz (source)
D/L audex-0.60a.tar.xz (source)
D/L audex-0.46b.tar.xz (source)




KDE Git

To get the most recent developers version of Audex clone the Audex Git repository:
git clone git://anongit.kde.org/audex



Debian

D/L i386 Package for stable/wheezy (0.79)
D/L AMD64 Package for stable/wheezy (0.79)

D/L i386 Package for oldstable/squeeze (0.79)
D/L AMD64 Package for oldstable/squeeze (0.79)

You will find Audex packages in the official repository.




Kubuntu

D/L x86 (64 bit) Package for utopic/14.10 LTS (0.79)

D/L x86 (64 bit) Package for trusty/14.04 LTS (0.79)

You can find Audex packages for Kubuntu in the official repository.




Chakra Project

Here you can find Audex in Chakra Project.




Archlinux

Here you can find Audex in Archlinux.




openSUSE

You can find RPM packages for openSUSE here.




Gentoo

Please look here.




Fedora

Please look here.




FreeBSD

Please look here.




(Released under the terms of the GNU General Public License)

Install

What you need

To compile (and run) Audex you need:


How to compile

To compile Audex extract the sources

tar xvf audex-0.79.tar.xz

and type in the source directory

mkdir build
cd build
cmake ..
make
make install

Uninstall with
make uninstall

from the build directory.


How to install Debian packages

To install the Debian packages please just type

sudo dpkg -i audex_0.79-1_amd64.deb

from the directory where your package is in and audex_0.79-1_amd64.deb is the name of your proper package.

If you have an older version installed, please uninstall it first:
sudo apt-get remove audex


Documentation

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 with the character in the parameter "replace_char_list_to". E.g. "*" is replaced with "+". 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 to true as a variable parameter, all spaces within will be replaced with 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. length, fillchar
$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