[PATCH] Docs - MythDVD/Running the Myth Transcoding Daemon (was Re: [mythtv-users] DVD transcoding Deamon)

[Michael T. Dean]

Mark Maas wrote:

> When I click the RIP-DVD button, it copmes up with an error message 
> claiming that I do not have the "transcoding deamon" operational? And 
> that I could try to start it by pressing a number key?

Robert,

Can we add something like this to the Myth docs?  The patch adds a new 
section under MythDVD that discusses testing and running the mtd.  We're 
getting this question a lot, so having a reference to the docs would be 
nice.  I didn't say anything about the auto-start (by hitting a number 
key) because it doesn't seem to work for a lot of people, and I don't 
know enough about it to tell them why...

Also, (having copied a link for use in my section,) I noticed that the 
name of the section, "Automatically starting mythbackend at system boot 
time," had been changed from, "I'd like to automatically start 
mythbackend at system boot time," so I fixed the reference in 
Configuring MythTV/Post-configuration to use the new title.

Please excuse my SGML.  It should be close, but I couldn't test it 
(don't have the tools installed).  If all else fails, the plain text is 
below (and I know you like that better than HTML ;).


Mark,

Here's the text I added to the docs:

Running the Myth Transcoding Daemon

Transcoding ("ripping") a DVD requires you to run the Myth Transcoding
Daemon (mtd).  To ensure that mtd operates properly, you should test it
as a foreground process.

$ mtd -n

The last line of text should show something like:

mtd is listening on port 2342

This indicates that mtd is ready for use.  Once you've successfully
tested mtd in the foreground, type CTRL-C to stop mtd.  You may
then start it as a background (daemon) process.

$ mtd -d

Running mtd as a daemon will allow you to have mtd automatically start
up during the boot process.  For example, you may add this to your
rc.local file, or you can adjust the script/steps outlined in the
section called "Automatically starting mythbackend at system boot time"
( http://www.mythtv.org/docs/mythtv-HOWTO-21.html#ss21.11 ) to start
mtd instead of mythbackend.

Mike
-------------- next part --------------
--- mythtv/docs/mythtv-HOWTO.sgml.orig	2004-07-09 16:22:14.000000000 -0400
+++ mythtv/docs/mythtv-HOWTO.sgml	2004-07-23 01:59:23.000000000 -0400
@@ -2664,7 +2664,7 @@
 to have mythbackend automatically start up during the boot process.  For
 example, you may add this to your <tt>rc.local</tt> file, or you can follow
 the steps outlined in the section called <ref id="mythbackend_autostart"
-name="I'd like to automatically start mythbackend at system boot time">.
+name="Automatically starting mythbackend at system boot time">.
 
 <sect1>Configuring a non-master backend <label id="nonmaster_backend">
 <p>Ensure that you've granted access to the master MySQL database for remote
@@ -4360,6 +4360,31 @@
 $ su
 # make install
 </verb></tscreen>
+<sect1>Running the Myth Transcoding Daemon
+<p>Transcoding ("ripping") a DVD requires you to run the Myth Transcoding
+Daemon (mtd).  To ensure that mtd operates properly, you should test it
+as a foreground process.
+<tscreen><verb>
+$ mtd -n
+</verb></tscreen>
+The last line of text should show something like:
+<tscreen><verb>
+mtd is listening on port 2342
+</verb></tscreen>
+This indicates that mtd is ready for use.  Once you've successfully
+tested mtd in the foreground, type <bf>CTRL-C</bf> to stop mtd.  You may
+then start it as a background (daemon) process.
+<tscreen><verb>
+$ mtd -d
+</verb></tscreen>
+
+Running mtd as a daemon will allow you to have mtd automatically start
+up during the boot process.  For example, you may add this to your
+<tt>rc.local</tt> file, or you can adjust the script/steps outlined in the
+section called <ref id="mythbackend_autostart"
+name="Automatically starting mythbackend at system boot time"> to
+start mtd instead of mythbackend.
+
 <sect>MythNews.
 <p>