Difference between revisions of "User Manual:Introduction"

From MythTV Official Wiki
Jump to: navigation, search
(I Want My MythTV!)
(Current Version: Updated for 0.25)
(35 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{NavigateFirst|User Manual:Index|User Manual:Initial Installation}}
+
{{User_Manual_TOC}}
  
Sometime back in 2002 (before May 15th, which is his first website news posting), [[User:Isaac|Isaac Richards]] decided he wanted something more from his television.
+
This page is up-to-date to MythTV version 0.20, the current release is {{CurrentRelease}}
 +
 
 +
==History of MythTV==
 +
Early in 2002 [[User:Isaac|Isaac Richards]] wanted more from his television and thought it might be fun to try to build a replacement for his AT&T broadband cable box.
  
 
He says:
 
He says:
  
:I got tired of the rather low quality cable box that AT&T Broadband provides with their digital cable service. It's slow to change channels, ridden with ads, and the program guide is a joke. So, I figured it'd be fun to try and build a replacement. Yes, I could have just bought a [http://www.tivo.com TiVo], but I wanted to have more than just a PVR -- I want a webbrowser built in, a mail client, maybe some games. Basically, I want the mythical convergence box that's been talked about for a few years now.
+
:I could have just bought a [http://www.tivo.com TiVo], but I wanted to have more than just a PVR -- I want a webbrowser built in, a mail client, maybe some games. Basically, I want the mythical convergence box that's been talked about for a few years now.
  
:So, in late April 2002, I started tinkering with stuff. I bought a cheap TV tuner card from [[Best Buy]], and threw it into my desktop box (P3-550). I started playing around with different video encoders, and eventually decided that [[NuppelVideo]] provided the best quality video for the amount of CPU it took up. It's based on a modified [[RTjpeg]] codec, and it looks rather nice, in my opinion.
+
In late April 2002, he started tinkering, installing a cheap [[Best Buy]] TV tuner card in his (P3-550) desktop box. He settled on the [[NuppelVideo]] video encoder on a quality/CPU load basis. It's based on a modified [[RTjpeg]] codec.
  
:Unfortunately, the poor P3-550 really couldn't encode and decode video at the same time. So, I took the plunge and bought a better machine — an Athlon XP 1800+. I based the machine off of an Abit NV7-133R motherboard, and put it into a nice black case.  
+
Because the P3-550 couldn't encode and decode simultaneously, he bought an Athlon XP 1800+ and an Abit NV7-133R motherboard, and put it into a nice black case. And the rest is history!
  
 
:See the news [http://www.mythtv.org updates/archives] for what's happened since.
 
:See the news [http://www.mythtv.org updates/archives] for what's happened since.
 
As we expand this manual, some of the more technical bits in that explanation will likely turn into hotlinks, but in the meantime, read on, Macduff.
 
  
 
==What is MythTV?==
 
==What is MythTV?==
  
MythTV is a collection of software which runs under the [http://www.linux.org Linux] operating system, and provides the functions commonly known as a PVR or DVR (personal, or digital, video recorder) — essentially, it's a computerized VCR, similar to a TiVo or a Replay... but since it's open source [http://www.opensource.org software], if you don't like the way it does something, you can always change it — that's how much of its current functionality came about in the first place.
+
MythTV is a collection of software that provides digital video recording functions (PVR or DVR--personal, or digital, video recorder) — a computerized VCR, similar to a TiVo or a Replay. It runs under the [http://www.linux.org Linux] operating system. Since it's open source [http://www.opensource.org software], if you don't like the way it does something, you can always change it — that's how much of its current functionality came about in the first place.
 
 
In addition to the basic PVR functions of recording and playing back scheduled programs and allowing you to schedule recordings automatically in advance, MythTV has a plugin system which permits it to be extended by other programmers; plugins currently exist for playing external video, viewing photos and listening to music files, using your TV and a web camera as a video-telephone over the Internet, browsing the web, retrieving current local weather, and many other functions.
 
  
There are two types of plugin for MythTV
+
In addition to the basic PVR functions of recording and playing back scheduled programs and allowing you to schedule recordings automatically in advance, MythTV has a plugin system that permits it to be extended by other programmers. Plugins currently exist for playing external video, viewing photos, listening to music files, using your TV and a web camera as a video-telephone over the Internet, browsing the web, retrieving current local weather, and many other functions.
  
The official [[:Category:Plugins|Plugins]], and the [[Unofficial Plugins]].
+
There are two types of plugin for MythTV, [[:Category:Plugins|official]], and [[Unofficial Plugins]].
  
 
==Current Version==
 
==Current Version==
  
As of late 2007, MythTV is in release version [[Release Notes - 0.20.2|0.20.2]]; this is probably a late-beta to gamma quality release despite its low version number (a common characteristic of [[Open Source Software]] projects). Features planned for an upcoming release, and available in the current [[Subversion|SVN]] for the brave, are listed at [[Under Development]]. New features in the current release can be found at [[Whats New|What's New]]
+
As of April 2012, MythTV is in release version [[Release Notes|0.25]]. Features planned for an upcoming release, or are currently available in the unstable/development version are listed at [[Under Development]]. New features in the current release can be found at [[Release Notes|what's new]]
  
 
==I Want My MythTV!==
 
==I Want My MythTV!==
  
MythTV isn't (yet) for everyone. While it's likely that at some point, you'll be able to treat it as an appliance, requiring no special care or maintenance, that day hasn't entirely arrived yet. There are companies selling pre-configured MythTV [[Commercial MythTV System|boxes]], and those units likely are stable enough to toss on the living room shelf and hand the remote to your kids, but if you're building one yourself (or having someone build one for you), then things may be just a touch more complicated — this is the price you pay for power and flexibility.
+
MythTV isn't (yet) for everyone; it's still somewhat high-maintenance. While some companies sell pre-configured MythTV [[Commercial MythTV System|boxes]] that are probably stable enough to toss on the living room shelf and hand the remote to your kids, if you're building one yourself (or having someone build one for you), the process may be more complicated — this is the price you pay for power and flexibility.
  
If you want to build yourself a MythTV box (there isn't really a great way to use MythTV unambiguously as a noun; that's my compromise), then there are two approaches you can take:
+
If you want to build yourself a MythTV box (there isn't really a great way to use MythTV unambiguously as a noun; that's my compromise), you can build it from your scrap box, or buy new components.
  
*Build it out of all those pieces you've got laying around.
+
Which of those two choices you'll make depends a lot on how much money (and what parts) you've got lying around and on how much work you want to do. If you choose each part specifically for the task you will likely spend a little more money and have a lot less hassle.
*Buy all the pieces from scratch.
 
  
Which of those two choices you'll make depends a lot on how much money (and what parts) you've got laying around, and on how much work you want to do — if you choose each part specifically for the task, you will likely spend a little more money, and have a lot less hassle.
+
[http://baylink.pitas.com I] built a [[Myth Box]] for my [http://www.bakulanews.com sister] and since she is the ultimate couch potato (the machine's name is, actually, 'potato' :-) and a hardcore taper (want a copy of a TV episode from 1989? She might have the entire series), the machine has to be a production-quality unit.
  
[http://baylink.pitas.com I] built a [[Myth Box]] for my [http://www.bakulanews.com sister], and since she is the ultimate couch potato (the machine's name is, actually, 'potato' :-), and she's a hardcore taper (want a copy of a TV episode from 1989? She might have the entire series), the machine has to be a production-quality unit.
+
For us, this indicated "buy all the parts new" and, since she was planning to have more than one tuner card (between 3 and 5, actually), it indicated "use hardware-MPEG tuners" as well. We'll get into those discussions in an appendix because this manual is aimed at the person with an operational [[Myth Box]] in front of them. If you haven't built one yet, check that section out — I'll be including links to useful information for making that decision.
  
For us, this indicated "buy all the parts new", and, since she was planning to have more than one tuner card (between 3 and 5, actually), it indicated "use hardware-MPEG tuners" as well. We'll get into those discussions in an appendix, since this manual is mostly aimed at the person with an operational [[Myth Box]] in front of them; if you haven't built one yet; check that section out — I'll be including links to useful information for making that decision.
+
== MythTV Configurations ==
  
==Basic Configuration==
+
A MythTV system can be configured in many ways--limited only by your imagination and your credit rating.
  
In the course of this manual, we will often have reason to refer to a Basic Configuration... mostly to point out something that can't be done unless you have more than that. :-)
+
There are two main logical elements in a MythTV system:
 +
* The backend contains the TV capture cards, and stores the recorded video. A typical system will contain at least one backend
 +
* The frontend is connected to your TV screen and lets you watch LiveTV and recorded shows. It gets its data from the backend.
  
My idea of a Basic Configuration for a [[Myth Box]] is this:
+
The simplest configuration, puts both frontend and backend in the same physical box.
  
*First you need a [[Linux Distros|Linux]] Distribution
+
An advanced setup might separate backend and frontend hardware.  For example, a high power backend system might employ multiple TV capture cards, detect commercials, run transcode jobs, etc., and hide in a closet, while one or several frontends can run on low power diskless and silent systems in each room where you want to watch TV. Nice, eh? You can deploy as many backends and frontends as you need, so let your imagination run free and tell us about your setups in this Wiki.
*A VGA card supported by linux, optionally with TV-out via composite or s-video
+
 
*256MB (preferably 512) or more of RAM,
+
Some people take the opposite approach and actually install MythTV backends on very low power backends such as [[Myth_On_NSLU2|Linksys NSLU2]] units, which are appropriate to record IPTV, for example, as long as they are connected to large disks for video storage.
*At least a 1500MHz CPU (for non-hardware-MPEG [[Tuner Card]]s) or,
+
 
*At least a 800MHz CPU (for hardware-MPEG [[Tuner Card]]s, including [[DVB|Digital TV]] cards),
+
In any case, the key points for each element are:
*At least a 2800MHz CPU (for HTDV recording playback)
+
 
*One [[Tuner Card]] of some flavor appropriate to the TV services you have available at your location, (ATI cards are not supported)
+
* Backend: large disk capacity, big horsepower in case you want to run transcode jobs or commercial detection
 +
* Frontend: good graphics card, compatible with the screen you want to use, and just fast enough to display the most demanding type of video you're planning to use.
 +
 
 +
As you can see, a combined backend/frontend system will need a fairly high-end machine if you want to get good performance, but fear not, Intel Core2 CPUs or equivalent AMDs  can provide a [[Gigabyte_GA-73PVM-S2H|decent system]] that runs silent at under 40W!
 +
 
 +
===Basic Configuration===
 +
 
 +
(This manual will often refer to a Basic Configuration--mostly to point out something that can't be done unless you have more than that! :-)
 +
 
 +
A Basic Configuration for a [[Myth Box]] is this:
 +
 
 +
*A [[Linux Distros|Linux]] Distribution
 +
*A VGA card supported by linux, optionally with TV-out via composite or s-video (or integrated video on the motherboard)
 +
*256MB (preferably 512) or more of RAM
 +
*A CPU that meets your needs:
 +
**At least a 800MHz CPU (for hardware-MPEG Tuner Cards, including [[DVB|Digital TV]] cards)
 +
**At least a 1500MHz CPU (if not using hardware-MPEG Tuner Cards)
 +
**At least a 2800MHz CPU (for HDTV recording playback)
 +
*One [[tuner card]] (also known as a "video capture card") of some flavor appropriate to the TV services you have available at your location, (ATI cards are not fully supported)
 
*At least 60GB of hard disk space, most of which can be used for storing recordings.
 
*At least 60GB of hard disk space, most of which can be used for storing recordings.
  
 
This is a basic system, which will let you [[Scheduling Recordings|schedule recordings]] and [[User Manual:Watch TV|watch live TV]], though not at the same time.
 
This is a basic system, which will let you [[Scheduling Recordings|schedule recordings]] and [[User Manual:Watch TV|watch live TV]], though not at the same time.
  
==Expanded Configuration==
+
===Expanded Configuration===
  
As you have money and motivation, you can expand your system in many ways.
+
With money and motivation, you can expand your system:
  
*You can add more [[video capture card]] inputs.
+
*Add more [[video capture card]] inputs.
*You can add more storage (some people, like [[User:David Greaves|David Greaves]], have a terabyte of spinning storage).
+
*Add more storage. Many users on the [[mailinglist]] have multiple terabytes of storage(via [[Storage Groups]] as of 0.21 and/or [[RAID]], which comes in handy with an [[HDTV]] capable system.
*You can add more [[Front End]] machines, to serve additional television sets.
+
*Add additional [[Mythfrontend|Front End]] machines to serve more TVs.
*You can add additional [[User_Manual:Detailed_configuration_Backend|Back End]] machines, to add even more [[video capture card]]s or storage, and to unload the processes of [[Commercial Recognition]] and [[Transcoding]] from the machines doing the recording.
+
*Add additional [[User_Manual:Detailed_configuration_Backend|Back End]] machines to add even more [[video capture card]]s or storage and to offload the processes of [[Commercial Detection]] and [[Transcoding]] from the machines doing the recording.
 
*There is growing list of [[Unofficial Plugins]] to expand the capability of your MythBox.
 
*There is growing list of [[Unofficial Plugins]] to expand the capability of your MythBox.
 
 
{{NavigateFirst|User Manual:Index|User Manual:Initial Installation}}
 

Revision as of 08:13, 9 May 2012


This page is up-to-date to MythTV version 0.20, the current release is 34.0

History of MythTV

Early in 2002 Isaac Richards wanted more from his television and thought it might be fun to try to build a replacement for his AT&T broadband cable box.

He says:

I could have just bought a TiVo, but I wanted to have more than just a PVR -- I want a webbrowser built in, a mail client, maybe some games. Basically, I want the mythical convergence box that's been talked about for a few years now.

In late April 2002, he started tinkering, installing a cheap Best Buy TV tuner card in his (P3-550) desktop box. He settled on the NuppelVideo video encoder on a quality/CPU load basis. It's based on a modified RTjpeg codec.

Because the P3-550 couldn't encode and decode simultaneously, he bought an Athlon XP 1800+ and an Abit NV7-133R motherboard, and put it into a nice black case. And the rest is history!

See the news updates/archives for what's happened since.

What is MythTV?

MythTV is a collection of software that provides digital video recording functions (PVR or DVR--personal, or digital, video recorder) — a computerized VCR, similar to a TiVo or a Replay. It runs under the Linux operating system. Since it's open source software, if you don't like the way it does something, you can always change it — that's how much of its current functionality came about in the first place.

In addition to the basic PVR functions of recording and playing back scheduled programs and allowing you to schedule recordings automatically in advance, MythTV has a plugin system that permits it to be extended by other programmers. Plugins currently exist for playing external video, viewing photos, listening to music files, using your TV and a web camera as a video-telephone over the Internet, browsing the web, retrieving current local weather, and many other functions.

There are two types of plugin for MythTV, official, and Unofficial Plugins.

Current Version

As of April 2012, MythTV is in release version 0.25. Features planned for an upcoming release, or are currently available in the unstable/development version are listed at Under Development. New features in the current release can be found at what's new

I Want My MythTV!

MythTV isn't (yet) for everyone; it's still somewhat high-maintenance. While some companies sell pre-configured MythTV boxes that are probably stable enough to toss on the living room shelf and hand the remote to your kids, if you're building one yourself (or having someone build one for you), the process may be more complicated — this is the price you pay for power and flexibility.

If you want to build yourself a MythTV box (there isn't really a great way to use MythTV unambiguously as a noun; that's my compromise), you can build it from your scrap box, or buy new components.

Which of those two choices you'll make depends a lot on how much money (and what parts) you've got lying around and on how much work you want to do. If you choose each part specifically for the task you will likely spend a little more money and have a lot less hassle.

I built a Myth Box for my sister and since she is the ultimate couch potato (the machine's name is, actually, 'potato' :-) and a hardcore taper (want a copy of a TV episode from 1989? She might have the entire series), the machine has to be a production-quality unit.

For us, this indicated "buy all the parts new" and, since she was planning to have more than one tuner card (between 3 and 5, actually), it indicated "use hardware-MPEG tuners" as well. We'll get into those discussions in an appendix because this manual is aimed at the person with an operational Myth Box in front of them. If you haven't built one yet, check that section out — I'll be including links to useful information for making that decision.

MythTV Configurations

A MythTV system can be configured in many ways--limited only by your imagination and your credit rating.

There are two main logical elements in a MythTV system:

  • The backend contains the TV capture cards, and stores the recorded video. A typical system will contain at least one backend
  • The frontend is connected to your TV screen and lets you watch LiveTV and recorded shows. It gets its data from the backend.

The simplest configuration, puts both frontend and backend in the same physical box.

An advanced setup might separate backend and frontend hardware. For example, a high power backend system might employ multiple TV capture cards, detect commercials, run transcode jobs, etc., and hide in a closet, while one or several frontends can run on low power diskless and silent systems in each room where you want to watch TV. Nice, eh? You can deploy as many backends and frontends as you need, so let your imagination run free and tell us about your setups in this Wiki.

Some people take the opposite approach and actually install MythTV backends on very low power backends such as Linksys NSLU2 units, which are appropriate to record IPTV, for example, as long as they are connected to large disks for video storage.

In any case, the key points for each element are:

  • Backend: large disk capacity, big horsepower in case you want to run transcode jobs or commercial detection
  • Frontend: good graphics card, compatible with the screen you want to use, and just fast enough to display the most demanding type of video you're planning to use.

As you can see, a combined backend/frontend system will need a fairly high-end machine if you want to get good performance, but fear not, Intel Core2 CPUs or equivalent AMDs can provide a decent system that runs silent at under 40W!

Basic Configuration

(This manual will often refer to a Basic Configuration--mostly to point out something that can't be done unless you have more than that! :-)

A Basic Configuration for a Myth Box is this:

  • A Linux Distribution
  • A VGA card supported by linux, optionally with TV-out via composite or s-video (or integrated video on the motherboard)
  • 256MB (preferably 512) or more of RAM
  • A CPU that meets your needs:
    • At least a 800MHz CPU (for hardware-MPEG Tuner Cards, including Digital TV cards)
    • At least a 1500MHz CPU (if not using hardware-MPEG Tuner Cards)
    • At least a 2800MHz CPU (for HDTV recording playback)
  • One tuner card (also known as a "video capture card") of some flavor appropriate to the TV services you have available at your location, (ATI cards are not fully supported)
  • At least 60GB of hard disk space, most of which can be used for storing recordings.

This is a basic system, which will let you schedule recordings and watch live TV, though not at the same time.

Expanded Configuration

With money and motivation, you can expand your system: