Debian Codegraph @

INSTALL

raw
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.