- 1 Introduction
- 2 Structure
- 3 Requirements
- 4 Getting Started
- 5 Installing MythTV
- 6 Frontend setup
- 7 MythTV Plugins
- 8 Environment Variables
- 9 Hints to a Happy Myth System
- 10 References
MythTV is an application suite designed to provide an amazing multimedia experience. It provides PVR functionality to a Linux based computer and also supports other media types. Combined with a nice, quiet computer and a decent TV, it makes an excellent centerpiece to a home theater system.
The MythTV system is split into a backend and a frontend. Each component has its own functions:
- Schedule and record television programming
- Stream video data to the frontend
- Flag commercial breaks
- Transcode videos from one format to another
- Provide a pretty GUI
- Play back recorded content
- Provide an interface to schedule programs
The frontend and backend may be on separate computers on a network, and there may also be multiple frontends. This architecture allows for a central media distribution system that can reach anywhere a network can. This is a remarkably flexible system, and it even allows very low power machines to act as perfectly usable frontends.
MythTV is a very scalable system. With standard definition television and pure MPEG2 encoding and decoding with hardware acceleration, even a very modest system can act as both frontend and backend. How modest? Some people report being able to use fanless Via systems with Hauppauge PVR cards for both backend and frontend simultaneously. While the author does not condone the use of such a lightweight system, it has been done successfully.
On the other end of the spectrum, high definition TV with MPEG4 transcoding and commercial flagging can require serious horsepower. Most people in the HD realm use high-end Athlon XPs, midrange to high-end Athlon 64s, and high-end Pentium 4s for their backends. The frontend can get away with a somewhat more midrange processor if XvMC playback acceleration is used.
All systems are going to need a tuner card. The Hauppauge PVR series of cards (150, 250, 350, and 500) are very popular for use with MythTV due to fairly decent Linux support and low CPU usage. Other cards, like those based on the BT878 chipset, are also used. Unlike the PVR series, BT878 based cards require significant amounts of CPU power to save the video, as these cards output raw frames and not compressed streams.
The only combination of hardware the author can say works is an Athlon XP 1700+ frontend with 512MB of DDR memory, and a Pentium 4 2.8GHz backend with 512MB of DDR2 memory.
In order to install MythTV on your system(s), you must have a working Linux installation. Since this is the Arch Linux website, this article will be geared towards Arch. A simple base system Installation with no extras is a suggested starting point.
For the backend, it is also good to have LAMP working properly so that anybody can use a web browser to schedule programming through MythWeb. While it is not necessary, it's a very handy feature.
A working Xorg (graphical) environment is necessary.
There is a MythTV package in Extra.
- Install the MythTV package:
# pacman -S mythtv
- If you get a libXvMCW.so.1 shared library error, install the following:
# pacman -S libxvmc
At this point you have a generic MythTV installation. It must be refined into a backend, a frontend, or both.
Before setting up your backend, make sure you have a functioning video capture card or firewire input from an STB. Unfortunately, that part of setup is outside the scope of this article. It is also helpful to have an account with DataDirect from Zap2It labs. If you are in the United States, this service provides TV listings at a minimal cost. All you have to do is take a survey every three months, and you get (monetarily) free listings. Users outside the United States will need to use screen scrapers (xmltv) to do the same job.
NOTE: DataDirect is closed. You can now use Schedules Direct.
Setting up the database:
- Install and run MySQL
# pacman -S mysql # /etc/rc.d/mysqld start
- Add mysqld to the daemons line in /etc/rc.conf.
- Import the database structure:
# mysql -u root -p < /usr/share/mythtv/mc.sql
Setting up the master backend:
- Start up X, if you haven't already:
- Open up xterm or another GUI terminal of your choice
- Run the mythtv-setup program
- General menu
If this is your master backend, put its IP address in the first and fourth fields, identifying this computer as your master and giving its network IP address.
On the next page, enter the paths where recordings and the live TV buffer will be stored. LVM or RAID solutions provide easily accessible large scale storage. But again, those are outside the scope of this article. Set the live TV buffer to a size you can handle and leave everything else alone.
On the next page, set the settings to your locale. NTSC is mostly used in North America, and be sure to set whether using cable or broadcast.
On the next two pages, leave everything as is unless you know for sure you want to change it. On the next page, if you have a fast backend that can handle recordings and flagging jobs simultaneously, it is recommended to set CPU usage to \"High\", maximum simultaneous jobs to 2, and to check the commercial flagging option.
On the next page, set these options to taste. Automatic commercial flagging is highly recommended. Ignore the next page and finish.
- Capture card menu
Select your card type from the drop down list. Hauppauge PVR users will select the MPEG-2 encoder card option.
Point mythtv-setup to the proper location, usually /dev/v4l/video0
- Video sources menu
This is where it gets important to have a source for TV listings. DataDirect users should create a new video source, name it, select the North America (DataDirect) option, and fill in their logon information. In order to verify that it is correct, go ahead and retrieve the listings.
NOTE: DataDirect is closed. You can now use Schedules Direct.
- Input connections menu
This menu is rather self-explanatory. All you need to do is pick an input on the capture card and tell myth which video source it connects to. Most users will select their tuner and leave all the other inputs alone. Satellite users will select a video input, and on the next page provide the command to change channels on their STB using an external channel change program. This is also outside the scope of this article.
- Channel editor menu
This menu is safe to ignore
- Exit the program (Esc)
- Run mythfilldatabase
This should populate your mysql database with TV listings for the next two weeks (or so).
- Add mythbackend to the /etc/rc.conf daemons line. If you find that mythbackend wont start on its own in the daemons line add HOME="/root" to /etc/rc.conf. I added it toward the top under the variables.
While it isn't absolutely necessary to restart at this point, it is a good idea just to clean things up and make sure that all the necessary daemons start up automatically.
Compared to the backend, getting a frontend running is trivially simple. Just make sure you are in an X environment as a normal user and run mythfrontend. It will pop up a menu asking about the IP address of the backend and the local computer's name and IP address. Fill in this information and your frontend should be functional. On the other hand, the frontend has more options than a luxury car. All of those are an article on their own. There are a few notable options that should be set to ensure a good working setup. If you don't have an interlaced monitor (and almost nobody does), you will need to deinterlace your television output. Go into the TV playback menu and select kernel deinterlacing or bob2x deinterlacing. Try both and see which you like better. Also, in the general settings page, it is good to set up your [Alsa setup] settings, but those vary so greatly it isn't worth suggesting values here.
One problem I encountered running mythfrontend 0.20.0.2007013 on fglrx was that the colors were mixed up. People were blue-skinned etc. It turns out there is a hack for ATI cards in the source, but it is not enabled. Uncomment #define USE_ATI_PROPRIETARY_DRIVER_XVIDEO_HACK in libs/libmythtv/videoout_xv.cpp and rebuild. (this will change names in svn and so future versions)
Nvidia XvMC Setup
Assuming you have loaded the proprietary Nvidia drivers from pacman you may need do the following:
echo "libXvMCNVIDIA_dynamic.so.1" > /etc/X11/XvMCConfig
This will allow Mythfrontend to use the XvMC environment for acceleration. Restart Mythfrontend
There are a number of plugins available for MythTV in the AUR. They range from RSS readers to DVD players. Take a look at them. Simply installing the package on the frontend computer should impart the intended functionality. There is rarely any additional setup, and when there is, the install file will mention it.
Mythweb will install in /srv/www/mythweb while Arch Apache2 defaults to /srv/http/.
A symlink will need to be added:
ln -s /srv/http/mythweb /srv/www/mythweb
The Mythweb package assumes nobody still runs the HTTP server, but that is no longer the case. Change the owner of the Mythweb files:
chown -R http.http /srv/www/mythweb/*
Make sure that PHP is enabled in Apache configuration. Edit /etc/httpd/conf/httpd.conf and add:
LoadModule php5_module modules/libphp5.so Include conf/extra/php5_module.conf
Make sure mysql, posix -modules are in PHP configuration. Edit /etc/php/php.ini and add: (These will be commented out in the default config file, so you can just find those lines and uncomment them.)
If you symlinked /srv/www/mythweb to /srv/http/mythweb, you will need to add /srv/www/ to the open_basedir path:
open_basedir = /srv/http/:/srv/www/:/home/:/tmp/:/usr/share/pear/
Enable allow_url_fopen if you want Mythweb's Status page to work: (by default it is 'Off', so find that line and toggle the value)
allow_url_fopen = On
Error reporting in PHP is by default disabled, enabling it makes debugging a lot easier.</p>
As of 7-10-08 Mythweather is broken in Extra
extra/mythweather 0.21-1 (mythtv-extras)
I found mythbackend would randomly stop running with the following error message:
Cannot locate your home directory. Please set the environment variable HOME or MYTHCONFDIR
So I did the following as root:
mkdir /home/mythtv ; cp /home/(myusername)/.lircrc /home/mythtv/ ; chown -R (myusername):users /home/mythtv
And then put the following in /etc/rc.conf
Hints to a Happy Myth System
But not full articles (yet)
- Run ntpd or openntpd on your backend to make sure it always has the right time.
- LIRC on your frontend allows you to use a remote control, which is wonderful in a living room.
- Use gdm, kdm, or xdm to automatically log in your frontend, and ~/.xinitrc to load mythfrontend on boot.
- Set the "automatically run mythfilldatabase" option on one of your frontends to make sure you always have listings.
- Don't forget to use the verbosity statements and log file location arguments to mythfrontend so you can see when things break.
- Don't run your frontend as root, create a mythtv user
Using GDM to autologin your Mythfrontend
In your /etc/gdm/custom.conf add the following statements under the [daemon] heading:
AutomaticLoginEnable=true AutomaticLogin=mythtv (assuming your frontend user is mythtv)
FYI - GDM will not autologin as root