Get MythTV from the mythtv.org web site. There are two installation methods you may choose from. The first is to download the latest release in tarball format and compile. The tarball release of MythTV should work on a wide variety of systems and should be the preferred method for new users. If you wish to use the CVS version of MythTV you may obtain it from CVS this way:
$ mkdir mythtv
$ cd mythtv
$ cvs -d :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs login
Logging in to :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs
CVS password: mythtv
$ cvs -z3 -d :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs checkout mythtv
.cvspass
file the very first time you run it. This is normal.
MythTV also maintains a CVS branch that incorporates bugfixes for issues discovered after a release has been packaged into a tarball.
If you would like to use code from this release branch, you would execute the following:
$ cvs -d :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs login
Logging in to :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs
CVS password: mythtv
$ cvs -z3 -d :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs co -r release-0-18-fixes mythtv
$ cvs -z3 -d :pserver:mythtv@cvs.mythtv.org:/var/lib/mythcvs co -r release-0-18-fixes mythplugins
If you wish to stay up-to-date with CVS, go into the MythTV subdirectory and type:
$ cd mythtv
$ cvs -z3 update -PAd
after you've done your initial download.
If you are in North America you will use the DataDirect grabber which is built-in to MythTV. You do not need to install XMLTV (so you may skip XMLTV-related instructions), but you need wget version 1.9.1 or higher.
Get XMLTV from http://xmltv.sourceforge.net. Download the latest version (0.5.39).
NOTE for Mandrake users: If you have added a "PLF" mirror, you may skip the next step and type: # urpmi libmp3lame0 libmp3lame0-devel NOTE for Red Hat users: If you are installing with apt or yum, you may skip this step, it will be taken care of. Otherwise get lame and lame-devel from <url url="http://ATrpms.net/name/lame/" name="http://ATrpms.net/name/lame/">. After downloading, be sure to install both: # rpm -Uvh lame*
Get lame from http://lame.sourceforge.net/. Download the source code to v3.96.1 by following the links from "Using" through "Download...".
Open a shell and switch to the directory where you saved lame.
$ tar -xzf lame-3.93.1.tar.gz
$ cd lame-3.93.1
$ ./configure
$ make
$ make test
$ su
# make install
Check that it worked:
# ls -l /usr/lib
-rw-r--r-- 1 root root 381706 Nov 4 14:22 libmp3lame.a
-rwxr-xr-x 1 root root 674 Nov 4 14:22 libmp3lame.la*
lrwxrwxrwx 1 root root 19 Nov 4 14:22 libmp3lame.so ->
libmp3lame.so.0.0.0*
lrwxrwxrwx 1 root root 19 Nov 4 14:22 libmp3lame.so.0 ->
libmp3lame.so.0.0.0*
-rwxr-xr-x 1 root root 360197 Nov 4 14:22
libmp3lame.so.0.0.0*
# exit
$
RPMs for XMLTV and all of its dependencies can be obtained from http://ATrpms.net/name/xmltv/. The web page has a list of all the dependent packages you must download and install.
# rpm -Uvh xmltv* perl*
If you install from this location you may skip to Manually building MythTV.
RPMs for XMLTV and all of its dependencies are located in Mandrake's "contrib". If you have added a contrib mirror, try installing XMLTV:
# urpmi xmltv xmltv-grabbers
If this does not work, it is possible that contrib for your Mandrake version
does not have XMLTV, so you may install the XMLTV prerequisites by typing:
# urpmi perl-xml-twig perl-xml-writer perl-datemanip perl-libwww-perl
and skip straight to the XMLTV compilation step.
$ tar -xjf xmltv-0.5.39.tar.bz2
Install the xmltv prerequisites. The following prerequisites are the
minimum required; when you actually start running the xmltv setup program it
may alert you to other modules that are required.:
$ su
# perl -MCPAN -e shell
cpan> install XML::Twig
cpan> install Date::Manip
Date::Manip is up to date.
cpan> install LWP
cpan> install XML::Writer
cpan> exit
Change to the XMLTV directory and compile it:
$ cd xmltv-0.5.39
$ perl Makefile.PL
You can answer "N" to the tv_check, tv_pick_cgi questions. Say "yes" to
the grabber required for your location.
You may get errors about modules not being installed. You will need to resolve any missing dependencies at this point, or your grabber may not work correctly.
$ make
$ make test
$ su
# make install
# exit
Zap2It DataDirect is a service provided by Zap2It, a subsidiary of
Tribune Media Services. TMS is one of the primary providers for program
listing data in the United States and Canada. There are a number of
advantages to using DataDirect rather than the standard XMLTV
tv_grab_na
grabber.
tv_grab_na
grabber is no longer supported and will not be
fixed when problems occur.If you wish to use Zap2It DataDirect, you'll need to establish a user account. Go to http://labs.zap2it.com and click on the "New User? Sign Up" link. Read the license terms, and if you agree with them click "Accept". The next screen is the subscription registration. In the "Certificate Code" field, enter ZIYN-DQZO-SBUT.
Fill in the survey, then proceed to the lineup choices and configure your account for your particular location and the channels that you have. This configuration will be imported into MythTV when you first run the setup program.
See the section called Migrating from XMLTV to DataDirect for instructions on moving to DataDirect if you are currently using XMLTV. If you are starting from a fresh installation, the simplest thing is to immediately start using DataDirect.
Unpack MythTV
$ tar -xjf mythtv-0.18.1.tar.bz2
$ cd mythtv-0.18.1
$ ./configure
As of MythTV version 0.18, there is no need to edit the
settings.pro
file to set compile-time options. The
configure script will configure MythTV appropriately for your
system. If you wish to change options, run ./configure --help to
see what is available and to override and automatically detected options.
See the config.log
file after running configure to see
previous runs.
On a single CPU machine, you would type the following to compile MythTV:
$ qmake mythtv.pro
$ make
If you want to build MythTV on a multi-CPU machine (or with distcc), specify "-j numjobs". In the following example, we will have two concurrent jobs executing. Do not set the number of jobs too high, or your compile will actually take longer to complete than it would if you did a "normal" build.
$ qmake mythtv.pro
$ make qmake
$ make -j 2
If you are using distcc, and you had two other host machines (red, blue) participating, you would do something like:
$ export DISTCC_HOSTS='localhost red blue'
$ qmake mythtv.pro
$ make qmake
$ make -j 6 CXX=distcc
The actual speed-up, if any, is dependant on a number of factors, such as
number of CPUs / hosts, etc. The distcc documentation recommends
using a -j
value of twice the number of CPUs available to keep all
of them busy.
Some timing information. The following should only be used for
illustration; your actual results may vary. The test involves a complete
make distclean
to the final binary.
In the above example, we see that with a single CPU, a multi-stage make does not significantly decrease compile time.
Once the compile is done, switch to superuser:
$ su
# make install
# exit
cd
'd to above.
MythTV supports real-time scheduling of the video output thread if it is installed SUID root.
This is an optional, but recommended step, if you understand the potential negative impact. As a positive, It can make the video display more smoothly, especially if you are decoding HDTV.
If the tradeoff is acceptable:
$ su
# chmod a+s /usr/bin/mythfrontend
# exit
$
NOTE: Making this change will affect your ability to run mythfrontend within gdb for debugging purposes. If you need to debug, you will need to run as root.
Since MythTV uses a client/server architecture, multiple frontend computers can simultaneously access content on a Myth system. Live TV, watching and scheduling recordings, etc. are all possible from multiple frontends.
To get a better picture of what is needed to run a frontend, note the following:
Other than the exclusion of the MySQL server and XMLTV, the MythTV compilation procedure is the same as when you're setting up both a backend and a frontend. However, you will need to install the database access libraries.
Once MythTV is compiled and installed:
Installation of MythTV on Gentoo consists of simply emerging the desired ebuild because all of the packages are now part of the official Portage tree.
$ su -
# emerge --sync # make sure portage is up to date.
# vi /etc/make.conf
Add mysql to your USE variable. i.e. USE="mysql ...."
# emerge mythtv