| 1 |
# |
| 2 |
# MP3Roaster INSTALL |
| 3 |
# |
| 4 |
# $Id: INSTALL,v 1.7 2005/10/09 14:04:40 eim Exp $ |
| 5 |
# |
| 6 |
|
| 7 |
0. Index |
| 8 |
-------- |
| 9 |
|
| 10 |
0. Index |
| 11 |
1. Introduction |
| 12 |
2. Requirements |
| 13 |
3. Install MP3Roaster |
| 14 |
4. Uninstall MP3Roaster |
| 15 |
|
| 16 |
|
| 17 |
1. Introduction |
| 18 |
--------------- |
| 19 |
|
| 20 |
In this file I will cover some basic instruction on how to install MP3Roaster |
| 21 |
on your system. Both installing and uninstalling the software should be |
| 22 |
quite easy and work on most UNIX like environments. |
| 23 |
|
| 24 |
MP3Roaster has been developed and tested on both Debian GNU/Linux and Red Hat |
| 25 |
(Fedora) Linux, all dependencies to run MP3Roaster are available for this |
| 26 |
GNU/Linux distributions. |
| 27 |
|
| 28 |
|
| 29 |
2. Requirements |
| 30 |
--------------- |
| 31 |
|
| 32 |
Here is a list of software dependencies of MP3Roaster, in poor words you |
| 33 |
need the free software listed below in order to run MP3Roaster on your box. |
| 34 |
|
| 35 |
. Perl Perl 5.6 or above (tested with 5.8) |
| 36 |
. Term::ReadKey Module for simple terminal control |
| 37 |
. File::MMagic Perl library to Guess file type |
| 38 |
. MPEG::MP3Info Perl library Manipulate / fetch info from MP3 audio files |
| 39 |
. Ogg::Vorbis::Header Perl extension for Ogg Vorbis streams |
| 40 |
. Audio::FLAC::Header Perl extension for FLAC files |
| 41 |
. Audio::Wav Perl extension for WAV files |
| 42 |
|
| 43 |
. cdrecord A command line CD writing tool |
| 44 |
. mpg321 or mpg123 A Free command-line mp3 player |
| 45 |
. ogg123 Plays Ogg Vorbis files |
| 46 |
. flac Decodes FLAC files |
| 47 |
|
| 48 |
Furthermore I suggest to install: |
| 49 |
|
| 50 |
. normalize Adjust the volume of WAV files to a standard volume |
| 51 |
level |
| 52 |
|
| 53 |
In order to install MP3Roaster from source and not as a Debian package |
| 54 |
you will also need this package: |
| 55 |
|
| 56 |
. GNU make The GNU version of the "make" utility. |
| 57 |
|
| 58 |
Here is a table of required Perl libraries and it's relative package names |
| 59 |
for various GNU/Linux distributions, if you can provide further infos to |
| 60 |
complete this table please drop us a line, thank you. |
| 61 |
|
| 62 |
+---------------------+---------------------------+------------------------+-----------------+ |
| 63 |
| Perl library | Debian GNU/Linux | Red Hat Linux | Slackware Linux | |
| 64 |
+---------------------+---------------------------+------------------------+-----------------+ |
| 65 |
| Term::ReadKey | libterm-readkey-perl | perl-TermReadKey | Unknown | |
| 66 |
| File::MMagic | libfile-mmagic-perl | perl-File-MMagic | Unknown | |
| 67 |
| MPEG::MP3Info | libmp3-info-perl | perl-MP3-Info | Unknown | |
| 68 |
| Ogg::Vorbis::Header | libogg-vorbis-header-perl | perl-Ogg-Vorbis-header | Not available | |
| 69 |
| Audio::FLAC::Header | libaudio-flac-header-perl | perl-Audio-FLAC-header | Unknown | |
| 70 |
| Audio::Wav | libaudio-wav-perl | perl-Audio-Wav | Unknown | |
| 71 |
+---------------------+---------------------------+------------------------+-----------------+ |
| 72 |
|
| 73 |
Red Hat Linux packages note: |
| 74 |
|
| 75 |
All Red Hat packages listed in the above table are currently available from |
| 76 |
ftp://prince.homelinux.org/software |
| 77 |
|
| 78 |
Debian GNU/Linux packages note: |
| 79 |
|
| 80 |
All the above listed packages are available in Debian GNU/Linux unstable. |
| 81 |
|
| 82 |
|
| 83 |
3. Install MP3Roaster |
| 84 |
--------------------- |
| 85 |
|
| 86 |
Once ensured that you have installed all the required software to run |
| 87 |
MP3Roaster and once download the latest source package or the CVS version |
| 88 |
of MP3Roaster you can proceed with this steps: |
| 89 |
|
| 90 |
1. Untar the MP3Roaster source package if downloaded as package: |
| 91 |
(If you have checked out the CVS source skip this step) |
| 92 |
|
| 93 |
% tar xfvz mp3roaster-<version>.tar.gz |
| 94 |
|
| 95 |
2. Move to the decompressed source folder and as root run: |
| 96 |
|
| 97 |
% cd mp3roaster-<version> Go to the source |
| 98 |
% su - Become root with su |
| 99 |
% make install Launch installation |
| 100 |
|
| 101 |
That's it, now MP3Roaster is installed system wide on your box, this means |
| 102 |
that all users of your system can use it. |
| 103 |
|
| 104 |
Do not remove the MP3Roaster source directory because you will need it to |
| 105 |
eventually uninstall the software, see "Uninstall MP3Roaster" for details. |
| 106 |
|
| 107 |
|
| 108 |
4. Uninstall MP3Roaster |
| 109 |
----------------------- |
| 110 |
|
| 111 |
Uninstalling MP3Roaster is as easy as installing it. |
| 112 |
Here are described the two simple steps for uninstalling the software: |
| 113 |
|
| 114 |
% cd mp3roaster-<version> Go to the source |
| 115 |
% su - Become root with su |
| 116 |
% make uninstall Launch uninstall |
| 117 |
|
| 118 |
That's it, now MP3Roaster is completely removed from your computer. |
| 119 |
Now you can delete also the MP3Roaster source directory. |