SoundGlue
by Phil Christensen
9-18-2005

This is a script that will handle the ins and outs of converting popular lossless
sound formats to mp3. To the purists, I say, "go to hell!", and to everyone else
I recommend not distributing the lossy files back to the world.

This has some tie-ins with etree.org, or more specifically, with FurtherNet,
although since the advent of BitTorrent, I guess FN doesn't get used quite as
much anymore.


INSTALL
--------
You'll need run the install.sh script as root:

	prompt#  sh install.sh

which will install the necessary things in the necessary places.

You will also need to add /usr/local/bin to your $PATH variable, if you haven't
already. Assuming your shell is bash, you should be able to run the following:

	prompt#  export PATH=$PATH:/usr/local/bin

After everything works, you can add that line (minus the prompt, of course) to
your ~/.profile file.


CONVERTING FLAC
----------------
If you wish to convert a directory of flac files called 'music' to mp3:

	prompt#  flac2mp3 music/

This will create the .mp3 files at the same level as the flac file.

You can also add an argument for a folder to extract to:

	prompt#  flac2mp3 music/ converted-music/

which is a bit more convenient. You can also convert a single file by specifying
it instead of a directory.


CONVERTING SHORTEN
-------------------
Shorten conversion works the same way:

	prompt#  shn2mp3 music/

	-OR-

	prompt#  shn2mp3 music/ converted-music/


DETAILS
--------
* All mp3s are created at 256kbps, CBR.
* Furthur incomplete directories (featuring a 'DO_NOT_EDIT' file) will be ignored.
* After conversion, the script creates an invisible '.converted' file in the
  converted directory. Directories containing this file will be ignored. If you
  need to convert a directory again, just delete this file from the command-line.