Difference between revisions of "User Manual:Introduction"

From MythTV Official Wiki
Jump to: navigation, search
(Current Version: MW doesn't seem able to do a "double redirect", so send "what's new" to Release Notes, directly (since the old What's New page simply redirected to an old Release Notes page).)
(remove section and joke)
 
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{User_Manual_TOC}}
+
{{User Manual TOC}}
 
+
{{UpToDate 0.27}}
This page is up-to-date to MythTV version 0.20, the current release is {{CurrentRelease}}
 
  
 
==History of MythTV==
 
==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.
+
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:
 
He says:
Line 10: Line 9:
 
: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.
  
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.
+
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!
 
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/news MythTV News Archive] for what's happened since.
  
 
==What is MythTV?==
 
==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 [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.
+
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 [http://www.opensource.org 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.
+
With MythTV, recordings can be scheduled from a listing service to record all episodes of a program, or they can be manually scheduled based on day and time. MythTV keeps track of previously recorded episodes, so that it can catch up on missed episodes without re-recoding ones already seen.
 
 
There are two types of plugin for MythTV, [[:Category:Plugins|official]], and [[Unofficial Plugins]].
 
  
==Current Version==
+
MythTV allows watching of live TV together with the ability to pause, rewind, fast forward.
  
As of mid 2010, MythTV is in release version [[Release Notes|0.24]]. 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]]
+
MythTV also has built in the ability to play videos from the file system, from a server, or DVDs. It can also play video DVDs. Most types of video are supported, but not DRM protected content. Encrypted DVDs can be played if you install libdvdread4 (available separately).
  
==I Want My 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 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.
  
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.
+
There are two types of plugin for MythTV, [[:Category:Plugins|official]], and [[Unofficial Plugins]].
  
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.
+
==Current Version==
  
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.
+
The current release is {{CurrentRelease}}. 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]]
 
 
[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.
 
 
 
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 ==
 
== MythTV Configurations ==
  
A MythTV system can be configured in many ways--limited only by your imagination and your credit rating.
+
A MythTV system can be configured in many ways.
  
 
There are two main logical elements in a MythTV system:
 
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 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 frontend is connected to your TV screen and lets you watch LiveTV and recorded shows. It gets its data from the backend. Of course you can just as easily watch on a computer monitor and speakers, or a laptop computer.
  
 
The simplest configuration, puts both frontend and backend in the same physical box.
 
The simplest configuration, puts both frontend and backend in the same physical box.
Line 52: Line 45:
 
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.
 
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 [[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.
+
Some people take the opposite approach and actually install MythTV backends on very low power systems 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.
  
 
In any case, the key points for each element are:
 
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
+
* Backend: large disk capacity, big horsepower if 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.
 
* 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!
+
A combined backend/frontend system can run with good performance on low end equipment.
  
 
===Basic Configuration===
 
===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 Basic Configuration for a [[Myth Box]] is this:
  
 
*A [[Linux Distros|Linux]] Distribution
 
*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)
+
*A VGA card supported by Linux.
*256MB (preferably 512) or more of RAM
+
*512MB (preferably 1GB) or more of RAM
 
*A CPU that meets your needs:
 
*A CPU that meets your needs:
**At least a 800MHz CPU (for hardware-MPEG [[Tuner Card]]s, including [[DVB|Digital TV]] cards)
+
**Almost any CPU made since 2005 will suffice if you are recording digital TV or using hardware assisted encoding.
**At least a 1500MHz CPU (if not using hardware-MPEG [[Tuner Card]]s)
+
*One [[tuner card]] (also known as a "video capture card") of some flavor appropriate to the TV services you have available at your location, supported by Linux or MythTV
**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 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.
+
With one tuner you can record and watch recordings at the same time, or watch live TV with that ability to pause live TV
  
 
===Expanded Configuration===
 
===Expanded Configuration===
Line 84: Line 73:
  
 
*Add more [[video capture card]] inputs.
 
*Add more [[video capture card]] inputs.
*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.
+
*Add more storage. Hard disk prices are coming down all the time.
*Add additional [[Front End]] machines to serve more TVs.
+
*Add additional [[Mythfrontend|Front End]] machines to serve more TVs.
 
*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.
 
*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.
 +
 +
For more information on hardware configurations refer to [[:Category:Hardware Setup | Hardware Setup]].
 +
 +
[[Category:Introduction|1300]]

Latest revision as of 04:19, 23 September 2021

Software-update-available.png This page is up-to-date as of MythTV version 0.27.6, 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 MythTV News Archive 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.

With MythTV, recordings can be scheduled from a listing service to record all episodes of a program, or they can be manually scheduled based on day and time. MythTV keeps track of previously recorded episodes, so that it can catch up on missed episodes without re-recoding ones already seen.

MythTV allows watching of live TV together with the ability to pause, rewind, fast forward.

MythTV also has built in the ability to play videos from the file system, from a server, or DVDs. It can also play video DVDs. Most types of video are supported, but not DRM protected content. Encrypted DVDs can be played if you install libdvdread4 (available separately).

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

The current release is 34.0. 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

MythTV Configurations

A MythTV system can be configured in many ways.

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. Of course you can just as easily watch on a computer monitor and speakers, or a laptop computer.

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 systems 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 if 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.

A combined backend/frontend system can run with good performance on low end equipment.

Basic Configuration

A Basic Configuration for a Myth Box is this:

  • A Linux Distribution
  • A VGA card supported by Linux.
  • 512MB (preferably 1GB) or more of RAM
  • A CPU that meets your needs:
    • Almost any CPU made since 2005 will suffice if you are recording digital TV or using hardware assisted encoding.
  • One tuner card (also known as a "video capture card") of some flavor appropriate to the TV services you have available at your location, supported by Linux or MythTV
  • At least 60GB of hard disk space, most of which can be used for storing recordings.

With one tuner you can record and watch recordings at the same time, or watch live TV with that ability to pause live TV

Expanded Configuration

With money and motivation, you can expand your system:

For more information on hardware configurations refer to Hardware Setup.