diff options
Diffstat (limited to 'abs/core/local-website/htdocs/mythtv-doc/mythtv-HOWTO-1.html')
-rw-r--r-- | abs/core/local-website/htdocs/mythtv-doc/mythtv-HOWTO-1.html | 272 |
1 files changed, 272 insertions, 0 deletions
diff --git a/abs/core/local-website/htdocs/mythtv-doc/mythtv-HOWTO-1.html b/abs/core/local-website/htdocs/mythtv-doc/mythtv-HOWTO-1.html new file mode 100644 index 0000000..2f9fb22 --- /dev/null +++ b/abs/core/local-website/htdocs/mythtv-doc/mythtv-HOWTO-1.html @@ -0,0 +1,272 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> + <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21"> + <TITLE>Installing and using MythTV: First things first.</TITLE> + <LINK HREF="mythtv-HOWTO-2.html" REL=next> + + <LINK HREF="mythtv-HOWTO.html#toc1" REL=contents> +</HEAD> +<BODY> +<A HREF="mythtv-HOWTO-2.html">Next</A> +Previous +<A HREF="mythtv-HOWTO.html#toc1">Contents</A> +<HR> +<H2><A NAME="s1">1.</A> <A HREF="mythtv-HOWTO.html#toc1">First things first.</A></H2> + +<P> +<FIGURE> +<EPS FILE="stop.eps"> +<IMG SRC="stop.png"> +<CAPTION><B>NOTE</B>: Please note that I, Robert Kulagowski, am <EM>NOT</EM> the +author/programmer of the MythTV application! I can not give you +personalized installation support. If you are having issues installing +MythTV you should examine the archives, or post your question to the +MythTV-users mailing list. If you send me "Does MythTV work with 'X'"? +messages - I will simply instruct you to ask your question on the +mythtv-users mailing list.</CAPTION> +</FIGURE> +</P> +<H2><A NAME="ss1.1">1.1</A> <A HREF="mythtv-HOWTO.html#toc1.1">What is MythTV?</A> +</H2> + +<P>MythTV is a GPL licensed suite of programs that allow you to build the +mythical home media convergence box on your own using Open Source software +and operating systems. MythTV is known to work on Linux and Mac OS X +(PowerPC and Intel). It does not run on Windows.</P> +<P>MythTV has a number of capabilities. The television portion allows you to +do the following: +<UL> +<LI>You may pause, fast-forward and rewind live Television.</LI> +<LI>You may install multiple video capture cards to record more than one +program at a time.</LI> +<LI>You can have multiple servers (called "backends"), each with multiple +capture cards in them. All scheduling is performed by the Master backend, +which arbitrates which recording will be performed by each device. All +recording requests are managed by the Master backend, so you can schedule a +recording from any client.</LI> +<LI>You can have multiple clients (called "frontends" in MythTV parlance), +each with a common view of all available programs. Any client can watch any +program that was recorded by any of the servers, assuming that they have the +hardware capabilities to view the content; a low-powered frontend will not +be able to watch HDTV, for example. Clients can be diskless and controlled +entirely by a remote control.</LI> +<LI>You may use any combination of standard analog capture card, MPEG-2, +MJPEG, DVB, HDTV, USB and firewire capture devices. With appropriate +hardware, MythTV can control set top boxes, often found in digital cable and +satellite TV systems.</LI> +<LI>Program Guide Data in North America is downloaded from +schedulesdirect.org, a non-profit organization which has licensed data from +Tribune Media Services. This service provides almost two weeks of +scheduling information. Program Guide Data in other countries is obtained +using XMLTV. MythTV uses this information to create a schedule that +maximizes the number of programs that can be recorded if you don't have +enough tuners.</LI> +<LI>MythTV implements a UPNP server, so a UPNP client should automatically +see content from your MythTV system.</LI> +</UL> + +Other modules in MythTV include: +<UL> +<LI>MythArchive, a tool to create DVDs</LI> +<LI>MythBrowser, a web browser</LI> +<LI>MythControls, an application to configure your remote control</LI> +<LI>MythFlix, a Netflix module</LI> +<LI>MythGallery, a picture-viewing application</LI> +<LI>MythGame</LI> +<LI>MythMusic, a music playing / ripping application which supports MP3 +and FLAC</LI> +<LI>MythNews, a RSS news grabber</LI> +<LI>MythPhone, phone and videophone using SIP.</LI> +<LI>MythVideo, DVD ripper and a media-viewer for content not created within MythTV</LI> +<LI>MythWeather</LI> +<LI>MythWeb, which allows you to control your MythTV system using a web +browser. With MythWeb, you can schedule and delete recordings, change +keybindings and more. With proper security, you may even schedule a program +over the Internet and have it immediately acted on by the Master backend.</LI> +</UL> +</P> +<H2><A NAME="ss1.2">1.2</A> <A HREF="mythtv-HOWTO.html#toc1.2">QuickStart</A> +</H2> + +<P>Custom mini-distributions are available to make it easier to install +MythTV. A mini-distribution removes many of the "general purpose" +workstation / server software packages that may be installed by default if +you use one of the big-name OS packages.</P> +<P>See +<A HREF="http://mysettopbox.tv">http://mysettopbox.tv</A> if you'd +like to install a custom version of Knoppix optimized for MythTV.</P> +<P>See +<A HREF="http://www.minimyth.org">http://www.minimyth.org</A> if you'd like +to install MythTV onto a diskless system.</P> +<P>See +<A HREF="http://bit.blkbk.com">http://bit.blkbk.com</A> if you'd +like to install MythTV on a Xbox. +<B>NOTE</B>: Site appears unmaintained.</P> +<P>See +<A HREF="http://wilsonet.com/mythtv/">http://wilsonet.com/mythtv/</A> for instructions tailored to RedHat's +Fedora Core distribution.</P> +<P>See +<A HREF="http://www.mythbuntu.org">http://www.mythbuntu.org</A> if +you'd like to install a customized version of Ubuntu optimized for MythTV.</P> +<P>There is a MythTV wiki at +<A HREF="http://wiki.mythtv.org">http://wiki.mythtv.org</A>.</P> +<P>If you are installing this version for Schedules Direct support, please see +the +<A HREF="mythtv-HOWTO-24.html#migratingtoSD">Migrating from DataDirect Labs to Schedules Direct</A> section for additional information.</P> + +<H2><A NAME="ss1.3">1.3</A> <A HREF="mythtv-HOWTO.html#toc1.3">Upgrading from previous versions</A> +</H2> + +<P>The upgrade from previous versions should be transparent. Any changes to +the database structure should be applied automatically.</P> +<P>It is <EM>strongly</EM> recommended that you back up your database before +installing a new version of MythTV.</P> +<P>See +<A HREF="mythtv-HOWTO-23.html#backupdb">Saving or Restoring the database</A> for instructions.</P> + +<H2><A NAME="how_to_obtain"></A> <A NAME="ss1.4">1.4</A> <A HREF="mythtv-HOWTO.html#toc1.4">How to obtain this document / PDF versions of this document </A> +</H2> + +<P>This HOWTO document is maintained at the primary MythTV website: +<A HREF="http://www.mythtv.org">http://www.mythtv.org</A> by Robert +Kulagowski +<A HREF="mailto:rkulagow@rocketmail.com">mailto:rkulagow@rocketmail.com</A>.</P> +<P>This document is available as a single-page HTML document at +<A HREF="http://www.mythtv.org/docs/mythtv-HOWTO-singlehtml.html">http://www.mythtv.org/docs/mythtv-HOWTO-singlehtml.html</A> or as a PDF +at +<A HREF="http://www.mythtv.org/docs/mythtv-HOWTO.pdf">http://www.mythtv.org/docs/mythtv-HOWTO.pdf</A>.</P> +<P>This HOWTO is for MythTV v0.21</P> +<P>Release notes for this version may be found in the MythTV Wiki at +<A HREF="http://www.mythtv.org/wiki/index.php/Release_Notes_-_0.21">http://www.mythtv.org/wiki/index.php/Release_Notes_-_0.21</A></P> + +<H2><A NAME="ss1.5">1.5</A> <A HREF="mythtv-HOWTO.html#toc1.5">Books about MythTV</A> +</H2> + +<P>If you would like to purchase a book specifically about MythTV:</P> +<P> +<UL> +<LI>Hacking MythTV, ISBN 978-0470037874 by Wilson, Tittel, Wright and Korelc</LI> +<LI>Practical MythTV: Building a PVR and Media Center PC, ISBN 978-1590597798 by Smith and Still</LI> +</UL> +</P> + +<H2><A NAME="ss1.6">1.6</A> <A HREF="mythtv-HOWTO.html#toc1.6">Document conventions</A> +</H2> + +<P>The following conventions are used throughout this document.<BR> +<B>boldface</B> - used for program names.<BR> +<CODE>typewriter</CODE> - used for program paths.<BR> +<EM>emphasis</EM> - Pay attention here.<BR></P> +<P> +<FIGURE> +<EPS FILE="warning.eps"> +<IMG SRC="warning.png"> +<CAPTION>Pay more attention.</CAPTION> +</FIGURE> +</P> +<P> +<FIGURE> +<EPS FILE="stop.eps"> +<IMG SRC="stop.png"> +<CAPTION>Ignore at your own peril.</CAPTION> +</FIGURE> +</P> +<P> +<FIGURE> +<EPS FILE="add.eps"> +<IMG SRC="add.png"> +<CAPTION>Feature that has been added to SVN (subversion, a revision control system) +but is not available in the current release.</CAPTION> +</FIGURE> +</P> + +<H2><A NAME="ss1.7">1.7</A> <A HREF="mythtv-HOWTO.html#toc1.7">Mailing lists / getting help</A> +</H2> + +<P>It's recommended that you join the user list at +<A HREF="http://www.mythtv.org/mailman/listinfo/mythtv-users">http://www.mythtv.org/mailman/listinfo/mythtv-users</A>. The developer +list is at +<A HREF="http://mythtv.org/cgi-bin/mailman/listinfo/mythtv-dev">http://mythtv.org/cgi-bin/mailman/listinfo/mythtv-dev</A>. Please keep +the developer list strictly for development-related issues.</P> +<P>Searchable archives for the lists are available at +<A HREF="http://www.gossamer-threads.com/lists/mythtv/">http://www.gossamer-threads.com/lists/mythtv/</A>.</P> + +<H2><A NAME="ss1.8">1.8</A> <A HREF="mythtv-HOWTO.html#toc1.8">IRC</A> +</H2> + +<P>There are two IRC channels dedicated to MythTV which can be found on +irc.freenode.net +<UL> +<LI>mythtv</LI> +<LI>mythtv-users</LI> +</UL> +</P> +<P>The <CODE>mythtv</CODE> channel is where the developers discuss code. It is +<EM>not</EM> a user-support channel. Please don't ask non-development +related questions there.</P> +<P> +<FIGURE> +<EPS FILE="stop.eps"> +<IMG SRC="stop.png"> +<CAPTION>Really. Even if there's no one in the mythtv-users IRC group or everyone +seems to be ignoring you.</CAPTION> +</FIGURE> +</P> + +<H2><A NAME="ss1.9">1.9</A> <A HREF="mythtv-HOWTO.html#toc1.9">Bug database</A> +</H2> + +<P>If you feel you need to contribute to a bug database, use the MythTV bug +ticketing system at +<A HREF="http://svn.mythtv.org/trac">http://svn.mythtv.org/trac</A>.</P> +<P>Good entries will contain the following: +<OL> +<LI>Qt version</LI> +<LI>Linux distribution</LI> +<LI>gcc version</LI> +<LI>the last entry in config.log to detail how you compiled</LI> +<LI>MythTV version numbers (<EM>e.g.</EM>from mythfrontend --version)</LI> +<LI>Hardware</LI> +<LI>How you are able to reproduce the bug</LI> +</OL> +</P> +<P>See the instructions on how to debug in +<A HREF="mythtv-HOWTO-22.html#debugging">Section 22</A>.</P> +<P>The bug database is not a chat room, so restrict your entries to what is +relevant. It's also not a repository of feature requests; a feature request +without an accompanying patch file to implement that feature will be quickly +closed. There is a feature wishlist on the wiki at +<A HREF="http://www.mythtv.org/wiki/index.php/Feature_Wishlist">http://www.mythtv.org/wiki/index.php/Feature_Wishlist</A>. There is no +guarantee that anything on the wishlist will ever get code written to +implement it.</P> +<P>If a developer closes out your bug, it's likely you didn't provide enough +information. Don't re-open a bug without providing additional information.</P> + +<H2><A NAME="ss1.10">1.10</A> <A HREF="mythtv-HOWTO.html#toc1.10">Contributing to this document</A> +</H2> + +<P>Contributions to the HOWTO are welcome, especially if you find a +grammatical or spelling error, or if the wording of something is just plain +confusing.</P> +<P>If you'd like to make a new contribution, create a ticket at +<A HREF="http://svn.mythtv.org/trac">http://svn.mythtv.org/trac</A> and +click "New Ticket". The type should be set to "patch" and the owner set to +"rkulagow" to ensure that I see your contribution.</P> +<P>Please send it as either SGML or as plain text. <EM>NO HTML</EM>. The +source used to create the HOWTO is in SGML / Linuxdoc. Do not be afraid of +SGML! A quick look at the source of this HOWTO will show that it is not +difficult, because there aren't that many tags to worry about, so at least +<EM>try</EM> to submit as SGML. See the Linuxdoc HOWTO at +<A HREF="http://www.tldp.org/HOWTO/Howtos-with-LinuxDoc.html">http://www.tldp.org/HOWTO/Howtos-with-LinuxDoc.html</A> for information +on the linuxdoc format itself, or look at the <CODE>mythtv-HOWTO.sgml</CODE> +file as an example.</P> +<P>To create the actual patch, run <B>diff -u origfilename newfile > +doc.patch</B> and attach your contribution to the trac ticket.</P> + +<HR> +<A HREF="mythtv-HOWTO-2.html">Next</A> +Previous +<A HREF="mythtv-HOWTO.html#toc1">Contents</A> +</BODY> +</HTML> |