#
How to ...? - fre:ac User Guide

fre:ac setup and special features guide

#### Contents

> How to compile fre:ac from source?

> How to install encoder/decoder xy?

> How to use output file name patterns in fre:ac?

> How to add a new translation to fre:ac?

> How to remove fre:ac from my computer?

#### How to compile fre:ac from source?

> In order to build fre:ac from source you should download the latest version of the fre:ac Component Development Kit (CDK) from www.freac.org first.

> You will also need the latest smooth Class Library sources from www.smooth-project.org and of course the fre:ac source code package or fre:ac sources checked out from CVS.

> - extract the contents of freac-cdk-1.x.zip to anywhere you like
> - create a directory structure like this:

>   > /cdk (contains directory system and cdk.bat)
>   > /cdk/freac (rename directory from freac-1.1.x.zip package)
>   > /cdk/smooth (rename directory from smooth-0.8.x.y.zip package)

> - run cdk.bat
> - enter: cd smooth && make programs && cd ../freac && make

#### How to install encoder/decoder xy?

> ##### Nero Digital HE-AAC Encoder

> > To install the Nero Digital HE-AAC Encoder for use with fre:ac, follow these steps:

> > - Download the Nero AAC Codec ZIP package from www.nero.com.
> > - Copy the file NeroAACEnc.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### QuickTime AAC Encoder

> > To install the QuickTime AAC Encoder for use with fre:ac, follow these steps:

> > - Download the QuickTime AAC command line encoder ZIP package from sites.google.com.
> > - Copy the file qaac.exe or qaac64.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### DivX AAC Encoder

> > To install the DivX AAC Encoder for use with fre:ac, follow these steps:

> > - Download the DivX AAC Encoder setup package from labs.divx.com.
> > - Run the setup executable and install the DivX AAC Encoder to a directory of your choice.
> > - Copy the file DivXAACEnc.exe from the DivX AAC Encoder installation directory to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Fraunhofer MP3 Surround Encoder

> > To install the Fraunhofer MP3 Surround Encoder for use with fre:ac, follow these steps:

> > - Download the Win32 command line encoder ZIP package from www.all4mp3.com.
> > - Copy the file mp3sEncoder.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Helix DNA Producer RealAudio Encoder

> > To install the Helix DNA Producer RealAudio Encoder for use with fre:ac, follow these steps:

> > - Create a Helix Community account at helixcommunity.org. You will need this account in order to be able to download the Helix DNA Producer application.
> > - Download the Helix DNA Producer Command Line App ZIP package from helix-producer.helixcommunity.org.
> > - Create a new directory named helix inside the codecs/cmdline subdirectory of your fre:ac installation path.
> > - Copy the contents of the directory producer from the ZIP package to the newly created codecs/cmdline/helix subdirectory of your fre:ac installation path. The file producer.exe should now reside inside the helix directory along with several other files and directories from the Helix DNA Producer package.

> ##### TiMidity Software MIDI Synthesizer

> > To install the TiMidity Software MIDI Synthesizer for use with fre:ac, follow these steps:

> > - Download the TiMidity CVS binary ZIP package from sourceforge.net.
> > - Download the Freepats ZIP package from freepats.zenvoid.org.
> > - Create a new directory named timidity inside the codecs/cmdline subdirectory of your fre:ac installation path.
> > - Copy the file timidity.exe from the TiMidity ZIP package to the newly created codecs/cmdline/timidity subdirectory of your fre:ac installation path.
> > - Copy the contents of the directory freepats from the Freepats ZIP package to the newly created codecs/cmdline/timidity subdirectory of your fre:ac installation path. The file crude.cfg should now reside inside the timidity directory along with several other files and directories from the Freepats package.

> ##### MPEG-4 Audio Lossless Encoder / Decoder

> > To install the MPEG-4 Audio Lossless Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the MPEG-4 ALS Windows Codec ZIP package from www.nue.tu-berlin.de.
> > - Copy the .exe file found in the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path renaming it to mp4als.exe.

> ##### True Audio Encoder / Decoder

> > To install the True Audio Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the TTA compressor for Windows ZIP package from www.true-audio.com.
> > - Copy the file ttaenc.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Flake FLAC Encoder

> > To install the Flake FLAC Encoder for use with fre:ac, follow these steps:

> > - Download the Flake Windows binary ZIP package from flake-enc.sourceforge.net.
> > - Copy the file flake.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### FLACCL OpenCL FLAC Encoder

> > To install the FLACCL OpenCL FLAC Encoder for use with fre:ac, follow these steps:

> > - Download the FLACCL RAR package from cuetools.net.
> > - Create a new directory named flaccl inside the codecs/cmdline subdirectory of your fre:ac installation path.
> > - Copy all files from the RAR package to the codecs/cmdline/flaccl subdirectory of your fre:ac installation path.

> ##### LAME MP3 Command Line Encoder

> > To install the LAME MP3 Command Line Encoder for use with fre:ac, follow these steps:

> > - Download the LAME release ZIP package from rarewares.org.
> > - Copy the file lame.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### TwoLAME MP2 Encoder

> > To install the TwoLAME MP2 Encoder for use with fre:ac, follow these steps:

> > - Download the TwoLAME binary ZIP package from rarewares.org.
> > - Copy the file twolame.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Aften AC-3 Encoder

> > To install the Aften AC-3 Encoder for use with fre:ac, follow these steps:

> > - Download the Aften Win32 binary ZIP package from sourceforge.net.
> > - Copy the file aften.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Apple Lossless Decoder

> > The Apple Lossless Decoder is bundled with the original fre:ac distribution so you normally do not need to install it manually.

> > If you still need to install or update the Apple Lossless Decoder manually, follow these steps:

> > - Download the generic Win32 compile ZIP package from www.rarewares.org.
> > - Copy the file alac.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### TAK Encoder / Decoder

> > The TAK Encoder / Decoder is bundled with the original fre:ac distribution so you normally do not need to install it manually.

> > If you still need to install or update the TAK Encoder / Decoder manually, follow these steps:

> > - Download the TAK ZIP package from thbeck.de.
> > - Copy the file takc.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Musepack Encoder / Decoder

> > The Musepack Encoder / Decoder is bundled with the original fre:ac distribution so you normally do not need to install it manually.

> > If you still need to install or update the Musepack Encoder / Decoder manually, follow these steps:

> > - Download the Musepack tools ZIP package from www.musepack.net.
> > - Copy the files mpcenc.exe and mpcdec.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### WavPack Encoder / Decoder

> > The WavPack Encoder / Decoder is bundled with the original fre:ac distribution so you normally do not need to install it manually.

> > If you still need to install or update the WavPack Encoder / Decoder manually, follow these steps:

> > - Download the WavPack Win32 ZIP package from www.wavpack.com.
> > - Copy the files wavpack.exe and wvunpack.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Thomson mp3HD Encoder

> > To install the Thomson mp3HD Encoder for use with fre:ac, follow these steps:

> > - Download the Win32 mp3HD toolkit ZIP package from www.all4mp3.com.
> > - Copy the file mp3hdEncoder.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### OptimFROG Encoder / Decoder

> > To install the OptimFROG Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the OptimFROG Win32 console ZIP package from www.losslessaudio.org.
> > - Copy the file ofr.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Shorten Encoder / Decoder

> > To install the Shorten Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the Shorten ZIP package from www.free-codecs.com.
> > - Copy the file shorten.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### La Lossless Audio Encoder / Decoder

> > To install the La Lossless Audio Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the La Windows setup package from www.lossless-audio.com.
> > - Run the setup executable and install the La encoder to a directory of your choice.
> > - Copy the file la.exe from the La installation directory to the codecs/cmdline subdirectory of your fre:ac installation path.
> > - Please note that the La encoder needs to stay installed on your system in order to use it in fre:ac.

> ##### RK Audio Encoder / Decoder

> > To install the RK Audio Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the RK Audio compressor ZIP package from www.free-codecs.com.
> > - Copy the file rkau.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

> ##### Qualcomm PureVoice Encoder / Decoder

> > To install the Qualcomm PureVoice Encoder / Decoder for use with fre:ac, follow these steps:

> > - Download the PureVoice Converter ZIP package from www.qualcomm.com.
> > - Copy the file pvconv.exe from the ZIP package to the codecs/cmdline subdirectory of your fre:ac installation path.

#### How to use output file name patterns in fre:ac?

> The output file name pattern can be configured on the Encoder page of the configuration dialog. You can use backslashes to specify directories and placeholders for referring to meta information. The following placeholders are available:

> - <artist> - The song artist
> - <title> - The song title
> - <album> - The album title
> - <disc> - The disc number
> - <track> - The song track number
> - <genre> - The song genre
> - <albumartist> - The album artist
> - <composer> - The song composer
> - <conductor> - The performance conductor
> - <year> - The year the song was published
> - <currentdate> - The current date formatted as yyyymmdd
> - <currenttime> - The current time formatted as hhmm

> The <disc> and <track> placeholders can be modified like <disc(n)> and <track(n)> where the (n) part specifies the minimum length of the disc or track number. Zeroes will be prepended if the actual number is too small. n may be in the range of 1 to 4 where 1 is the default for disc and 2 is the default for track numbers if the (n) part is omitted.

> The above placeholders refer to song and album information. The following placeholder resolves to the type of the output file:

> - <filetype> - The type of the output file

> A common use case for this placeholder is if you are regularly encoding to different formats (e.g. FLAC for archival and M4A for your mobile player) and would like to keep the encoded files in separate directory trees.

> In addition to the above there are two placeholders that refer to the original file name of a file being encoded in fre:ac:

> - <filename> - The file name of the input file
> - <directory> - The directory the input file is found in

> The <directory> pattern is special as you can modify its meaning using two numerical arguments. You can use it like <directory+n> or <directory+n(m)>. In these expressions, the n specifies the number of path components that should be stripped from the beginning. The m specifies the number of components to use from what is left. Omitting the (m) part will use all components left in the path after stripping n components from the beginning. <directory> without any arguments will resolve to the complete path.

> So how to use this in practice? Assuming you have your music collection ordered like this:

> > C:\Music\[other criteria]\[artist]\[album]\[track] - [title]

> You might have a file called C:\Music\Favorites\Starsailor\Silence is Easy\01 - Music was Saved.flac.

> Now let's say you want to encode some music files for use on your portable player and put them in C:\Encoded\. In order to keep your [other criteria] field, you need to use the <directory> pattern. If your encoder output directory is set to C:\Encoded\, your complete filename pattern could look like this:

> > <directory+1(1)>\<artist> - <album>\<artist> - <album> - <track> - <title>

> This would encode the beforementioned file to C:\Encoded\Favorites\Starsailor - Silence is Easy\Starsailor - Silence is Easy - 01 - Music was Saved.m4a.

#### How to add a new translation to fre:ac?

> Please use the smooth Translator utility included in the fre:ac distribution and open an existing translation file (found in the freac/lang directory). Then change the language settings to reflect the translation you want to create and start translating the individual text strings. Save your translation as a new file matching the pattern freac_??.xml (replace ?? with your language code), restart fre:ac and try selecting the new translation in the configuration dialog.

> Please submit your translation to translations@freac.org, so it can be included in the official distribution.

#### How to remove fre:ac from my computer?

> Recent versions of fre:ac come with an uninstaller that you can execute from the Start menu.

> In case you removed the Start menu group or are unable to find it, it is completely sufficient to delete the application directory to uninstall fre:ac. fre:ac does neither create any Windows registry entries nor store any active components outside its installation directory.