*acidrip Installation HowTo - "things that go pfft" Version.
*v0.3 by trickykid (aka Drew Bentley)
January 25, 2003* *

------------------------------------------------------------------------
*
*

*1.0 About*

    * 1.1 About acidrip
    * 1.2 Legal Stuff

*2.0 Requirements*

    * 2.1 What you will need
    * 2.2 Optional packages
    * 2.3 Download information

*3.0 Installation*

    * 3.1 Preparation for installation.
    * 3.2 Installation
    * 3.3 Starting and somewhat using acidrip

*4.0 Wrapup*

    * 4.1 Credits
    * 4.2 Contact Information

------------------------------------------------------------------------


  *1.0 About*


  1.1 About acidrip

AcidRip is a Gtk::Perl <http://www.gtkperl.org/> application for ripping
and encoding DVD's. It neatly wraps MPlayer and MEncode
<http://mplayerhq.hu/>r, which I think is pretty handy, seeing as
MPlayer is by far the best bit of video playing kit around for Linux. As
well as creating a simple Graphical Interface for those scared of
getting down and dirty with MEncoders command line interface, It also
automates the process in a number of ways:

    * Parses DVD into contents tree
    * Finds longest title
    * Calculate video bitrate for given filesize
    * Finds black bands and crops them
    * Other stuff!


  1.2 Legal Stuff

Most likely this program follows the GPL but unsure since the author of
the program never mentions it. But the program is totally free for
download and use. Also to add I don't think there is any warranty for
using this program, the author is in no way liable for misuse of the
program. By using this program you will be totally liable so don't come
crying about how you trashed your system by using or installing this
program. No legal action can be taken upon the author for any reason for
the use of this program.

------------------------------------------------------------------------


    2.0 Requirements


    2.1 What you will need

acidrip which you will want to download from Sourceforge
<http://sourceforge.net/projects/acidrip/> requires several other
packages to perform and function properly. Here is the requirements of
what you will need:

*Hardware needed:*

Most likely your going to need a DVD player or this program will serve
you no purpose. And of course a working computer.

*Software needed.*

Basically you will need a working Linux system. I recommend Slackware
<http://www.slackware.com> myself and as you will find out soon,
everything downloaded is in source form, so if your use to using wussy
RPM's get over it now and hopefully you have GCC
<http://www.gnu.org/directory/GNU/gcc.html> installed with all the other
requirements to install source packages. You will most likely need the
latest version of Perl <http://www.perl.com> installed. Not necessarily
the latest version but you might as well if you don't already have it.

    * *acidrip* - Latest version currently is 0.7 "things that go pfft"
    * *lsdvd* - A small C program which is a requirement also written by
      Chris Phillips.
    * *MPlayer* - The best movie player for Linux.
    * *libdvdread* - The most popular dvd reading library for *nix.
    * *gtk-perl* - You'll most likely need to install this so you can
      use the graphical interface.


    2.2 Optional packages

Along with the actual requirements, there are some other recommendations
you might want to consider when using acidrip. The first would be
*lame*. Read all about it here <http://lame.sourceforge.net/>, you'll
see what its used for as I don't feel like explaining it. You can also
consider downloading and installing *libdvdcss* but acidrip will
function properly without either of these.

Any other options for MPlayer like skins or other types of codecs, fonts
are all ok to download install, as they are not needed to run and use
acidrip as well.


    *2.3 Download information*

    * *acidrip and lsdvd* - http://sourceforge.net/projects/acidrip/
    * *Mplayer* - http://www.mplayerhq.hu/homepage/dload.html
    * *libdvd* -
      http://www.dtek.chalmers.se/groups/dvd/dist/libdvdread-0.9.3.tar.gz
    * *gtk-perl* - http://www.gtkperl.org/Gtk-Perl-0.7008.tar.gz

------------------------------------------------------------------------


      3.0 Installation

*3.1 Preparation for installation*

Well obviously the first thing your going to want to do is download the
requirements. It is fine to download them to your /home directory of
whatever user your logged in as.
Some basic steps you will want to perform that makes the rest of the
installation and later use of acidrip will be mentioned now. Lets make a
symlink to your dvd device. Now for instance if your DVD drive like mine
is on your second IDE controller as the Slave device, its device name is
/dev/hdd. So this is what I did to make the symlink:

*$ su
# cd /dev
# ln -s /dev/hdd dvd
# exit*

Basically we su'd to root for access to create the symlink. Created the
symlink then exited back out of root. I always make it a habit not to be
logged in as root all the time. And you don't have to type the $ or #
signs, those are there to indicate the shell prompt and if your logged
in as either a regular user or root.

Now at this point, it is a good idea if you want to install any other
options for mplayer for example lame, now is the time to do that. That
way when you install MPlayer, it detects any codecs that you may want
installed. And don't think I'm going to show you how to install those,
cause I'm not, refer to their installation instructions for help.

*3.2 Installation*

Now for the required packages, we will start with the Gtk-Perl. First
you will want to unpackage it with the tar command.

*$ tar -xvf Gtk-Perl-0.7008.tar.gz*

Now you'll see all those files fly past you on your screen. At this
point it should have created a new directory called *Gtk-Perl-0.7008* in
your home directory. Follow these steps to install this package properly
onto your system:

*$ cd Gtk-Perl-0.7008
$ perl Makefile.PL
$ make
$ su -m
# make install
# exit*

Any other options at this time when installing Gtk-Perl you will want to
refer to the INSTALL and README files within that directory as with any
of the other packages were going to be installing after this one. Now
that Gtk-Perl is installed we can now install *libdvdread. *Oh and if
your wondering what the su -m is used for, its to su to root and stay in
your present working directory. If that -m flag does not work for you,
you'll just have to su to root then cd back into the directory your
currently installing the package in.

To unpack and install, follow these steps:

*$ tar -xvf libdvdread-0.9.3.tar.gz
$ cd libdvdread-0.9.3
$ ./configure
$ make
$ su -m
# make install
# exit*

Next for some reason on some systems when you install *libdvdread*, it
will install the *libdvdread.so.2* file to */usr/local/lib* which is
read by the lsdvd package that is required. You can check your
*/etc/ld.so.conf* to check if /*usr/local/lib* is listed but for some
reason it still may not find it after we install lsdvd. So to save some
time, lets go ahead and copy the *libdvdread.so.2* to your */usr/lib*
directory which will save some time scratching your head later on.
Now if you don't know how to simply copy a file over from one directory
to another, you might as well quit now and save yourself some time cause
I'm not going to show you how to do that. man cp for details if you do
want to continue but still unsure how to copy files.

Now we can go ahead and install MPlayer. Oh you already have it you say,
go ahead and remove it and lets install the latest version. But you have
the latest version? I said lets remove MPlayer from your system and get
on with installing it.

To install MPlayer at this time follow these steps and also remember if
you want any other codecs, fonts, etc, be sure to install them before
doing this step so MPlayer detects them. ( Also take notice now we don't
have a tar.gz file but a tar.bz2 file, be sure to look closely on how to
unpack it or it will give you errors):

*$ tar -yxvf MPlayer-0.90pre10.tar.bz2
$ cd MPlayer-0.90pre10
$ ./configure
$ make
$ su -m
# make install*

Now that we have Gtk-Perl, libdvdread and MPlayer installed, its now
time to install the main part for acidrip. Before installing acidrip
itself, we want to install lsdvd. Basically at this point you should be
able to handle installing this type of file without me explaining the
steps once again. Its just like installing libdvdread above but instead
you unpack lsdvd-0.5.tar.gz with the tar command, then cd into the new
directory called lsdvd-0.5 then run the rest like ./configure, make, su
-m, make install. Damn. I basically just told you all the steps there.
Oh well.

Now at this point, we will want to install acidrip itself. Alright,
hopefully your last step before getting to use the program.

Take these steps to install acidrip:

*$ tar -xvf acidrip-0.6.tar.gz
$ cd acidrip-0.6
$ perl Makefile.PL
$ make
$ su -m
# make install
# exit*

Hopefully all goes well after that last install with no compiling
errors. Basically if you have problems installing either acidrip or
lsdvd, you can visit the Forums at Sourceforge
<http://sourceforge.net/projects/acidrip/> for any questions or want to
leave a comment on this awesome program. For all the other programs we
installed like Gtk_Perl, MPlayer, etc, go to their site for help if you
get errors while installing them, as they are going to have better
documentation and more knowledge of their own products. Or maybe go to
www.linuxquestions.org <http://www.linuxquestions.org> which is the best
resource for newbies. But don't be offended if we tell you to RTFM,
which is always a good habit to have.

*3.3 Starting and somewhat using acidrip*

Well basically to run acidrip, just type *acidrip* at a command prompt.
If you want to create a pretty little link on your desktop or a panel
like in Gnome or KDE, your on your own. But however I do plan on making
a logo for the program and maybe an icon for desktop use as given
permission from the creator.

The rest of the program once started is pretty self explanatory. I'll
leave it as that for now. I might come around and write a small part on
how to use the program itself one day, but for now I'm too busy ripping
movies.

------------------------------------------------------------------------


        4.0 Wrapup

*4.1 Credits*

acidrip along with lsdvd is written and created by Chris Phillips, also
known as acid_kewpie.

trickykid is just a monkey writer of this howto for you stupid newbies,
its not that easy of an installation so I thought I would write a howto
so it makes it easier for everyone to install and use so this program
becomes more popular so acid_kewpie can start his monopoly in the dvd
ripping industry.

*4.2 Contact Information*

acid_kewpie can be emailed by clicking here
<mailto:acid_kewpie@users.sourceforge.net> and he wants feedback. So if
you have something to say about this program, drop him a line or visit
his Sourceforge page and drop a line in the Forums there.

To email the author of this fscking awesome howto, drop him a line here
<mailto:drew@jabentley.com?subject:acidrip%20howto>.

 

/Disclaimer: This howto can be distributed in anyway, shape or form. Its
free and is not restricted in anyway. Though the other programs listed
and any other trademarks mentioned are rightful to their respected owners./

