Valid HTML 4.0!

Table of Contents   Advanced Topics   Deal Database Forum

External Options

Most users will want to use TyTool's internal telnet client to run tserver on the TiVo, but there are two external methods of running tserver which may appeal to some users.  The first is to simply open an external telnet client such as Procomm Plus, NetTerm, or the one provided with Windows.  The user opens a session to the TiVo and at the bash prompt types the fully qualified pathname with options for tserver.  For example:

/var/hack/TyTool/tserver -s /var/hack/TyTool/NowShowing.tcl

Update: The most recent build of tserver, courtesy of DealDatabse Username Jamie, eliminates the need for the NowShowing.tcl script and the -s option in tserver.

Another option is to have tserver run automatically when the TiVo starts up.  This option is somewhat attractive because the user does not have to remember to run tserver before TyTool tries to interact with the TiVo.  There are some caveats, however:

1. In very rare cases, tserver might hang.  This would require telnetting to the TiVo and either shutting down tserver and re-running it, or rebooting the TiVo.

2. Setting up tserver to run at boot time requires changing the running partition to read-write and editing the rc.sysinit file.  A mistake could render the TiVo inoperable.

Warning: If the user is not extremely familiar with Linux and modifying a running drive partition, it is not recommended the user attempt to modify rc.sysinit.  DealDatabse, Josh Dinerstein, and the TiVo hacking community will not be held responsible if a TiVo unit is rendered inoperable by attempts to modify it.

The steps to modify rc.sysinit so tserver runs at startup are as follows:

1. Telnet to the TiVo to be modified.

2. Verify which partition is mounted as root (/) by typing mount.  Ordinarily the root partition is /dev/hda4.  The output of the mount command will contain a line like:

/dev/hda4 on / type ext2 (ro)

3. Issue the following command to enable the boot partition as read-write:

mount -o remount,rw /dev/hda4

assuming the root partition is /dev/hda4. Adjust the command line if some other partition is root.

4. Issue the mount command again with no options to insure the boot partition has been updated as read-write. The output should now look like this:

/dev/hda4 on / type ext2 (rw)

5. For safety, create a backup of the rc.sysinit file by issuing the following commands:

cd /etc/rc.d

cp rc.sysinit rc.sysinit.sav

6. Edit the existing rc.sysinit to include a line which runs tserver. I personally prefer to copy the file over to the PC using ftp, use a UNIX aware editor (like Edit Plus) to modify the file, then copy it back to the TiVo. Take care not to corrupt the carriage returns. Add the following line to the end of the rc.sysinit file (assuming tserver is in /var/hack/TyTool):

/var/hack/TyTool/tserver -s /var/hack/TyTool/NowShowing.tcl

Update: The most recent build of tserver, courtesy of DealDatabse Username Jamie, eliminates the need for the NowShowing.tcl script and the -s option in tserver.

7. It is extremely important the user remounts the root partition as read-only before the TiVo is ever rebooted. One good recommendation for those who may remount the partition as read-write fairly often is to create an exit script which automatically remounts / as read-only whenever the user exits the telnet session.  To make the root partition read-only, issue the following command (assuming /dev/hda4 is mounted as /):

mount -o remount,ro /dev/hda4

8. Issue the mount command again with no options to insure the boot partition has been updated as read-only. The output should now look like this:

/dev/hda4 on / type ext2 (ro)

9. Reboot the TiVo.


Table of Contents   Advanced Topics   Deal Database Forum