DailyMail Module

2nd May 2006:

v1.01 - Formal Release

This version is a formal release of the v0.38.8 release, with a few extras and recent bug fixes inspired from the TiVo community forums (up to 2nd May '06). Unfortunately the data sheet is not 100% complete yet, so please bear with me whist this is finished. Thanks for all those that have contributed to testing and to documentation generation - really appreciated. Please report bugs and issues on the TiVo community forum when you bump into them. See the "DailyMail Jazz Install Instructions v1.01 02May06 - In Progress.doc" file in the download zip file for installation instructions etc. Apologies for the huge delay in updating this web site.

You may download it from here:

• v1.01 download.

v1.0 - First Formal Release

The Sep / Oct '06 version - you may download it from here:

• v1.0 download.

v0.38.8 - Testing Release

This version has been released for testing purposes - only those with a great deal of patience and a strong stomach need apply!. Please report bugs and issues on the TiVo community forum when you bump into them. This release is only for the bold and the experienced, so if you are a new user please install a proven and stable previous version - once tested I will fully document this module and release formally. The zip file contains a high level datasheet.

You may download it from here:

• v0.38.8 beta download.

Here are the new features:

Basic Instructions:

Replace your current files with the replacement files provided. Add new files where provided:

• Your Image Server:

• Replace all images with new ones provided.

• Your TiVo:

• /var/hack directory:

• Replace all files provided and add others:

1. trackerupdate.tcl – cron-able tracker module.

• /var/hack/dailmail directory:

• Replace all files provided and add others:

1. dailymail.cfg – replace configuration file

2. dailymail_jazz.tcl – main TCL module

3. dailymail_jazz – executable shell module (not in-line) if you are calling dailymail_jazz from cron or telnet command line you must call this script – do not call

4. dailymail_jazz.tcl directly.

5. Ip-utilities.tcl – an ip utilities file

• /var/hack/tivoweb-tcl/modules directory:

• Replace all files provided and add others:   

1. controlpadding.itcl   

2. handlemultievents.itcl

3. managedailymail.itcl    

• /var/hack/dailymail/base64images directory:

• All .txt files provided should be placed in here

It is envisaged that the main dailymail files will be deposited in a /var/hack/dailymail directory. This is a change from previous versions. It is also essential that the dailymail_jazz.tcl module is never called directly, that is it called via the dailymail_jazz shell script file. To run from the command line type:

/var/hack/dailymail/dailymail_jazz [enter]

An example cron line entry may be:

45 5 * * 0-6  /var/hack/dailymail/dailymail_jazz.sh &

Which will run dailymail_jazz at 4.45am every day. If you try to call the dailymail_jazz.tcl file directly it will not execute.

If you are going to use the embedded image functionality please ensure you have created a “base64images” directory (mkdir base64images) in the dailymail directory, and place all the .txt files in it. You must consider the following variables in order to use this functionality:

• 2.2.8 – embeddedimages (set to true)

• 4.16 – embeddedimagesloc (probably ok to leave as is as long as used default directory structure)

Please note that the view html page functionality does not display images if you use the embedded functionality.

You should copy the ip utilities file to the /var/hack/dailymail directory.

Non Customizable Updates:

• Completely re-structured configuration file to be easier to use and understand.

• Added support of the “EHLO” command in order to get greater debugging information on allowed authentication methods when interacting with the mail server. The module will also automatically retry a “HELO” command on fail of the “EHLO” command.

• Completely re-written disk checking / percent used aspect of module utilizing code from TiVoWebPlus, with a view to fixing issue for some later version TiVos.

• Tidied up various presentation aspects of the email, including textual formatting and wrapping where required, plus attempted to reduce possibility of email be treat as spam.

• Updated Thumb presentation in the “To Do” list to show predicted, explicit and implied thumbs, including an “unset” thumb for the odd occasion when that situation occurs.

• Fixed bug where the up-time and temperature are not displayed in the status section.

• Improved debugging messaging throughout module.

• Provided a non-graphical equivalent space bar in the bulletin area.

• Streamlined date and time text in “To Do” list.

• Updated graphics throughout.

• Rewrote rejected recording code to be more effective and information rich.

• Created new .itcl tivoweb module to support “multi” functionality.

• Wrote cron callable Tracker update module, based on Sanderton’s Tracker code.

• Fixed time offset setting.

• Fixed minor problem with endpad display when the subsequent program is not recorded due to endpad driven overlap.

• Sorted out alt and title generation throughout module.

• Added javascript pop-up space info box for spaceguage and info icon .

• Adding in code that stops to-do list endpad functioning if more than 1 tuner is detected - module does not support dual tuners.

• Arrange it such that all version numbers are calculated by module – no use specification of version required – removed them from config file.

• Added in more flexibility around cron - day of month reporting.

Customizable Options:

• Modified usage of the TiVo’s name. This can be customised through setting the “tivoName” variable in the configuration file (3.1.1).

• Added selectable support for second disks, or a disk “B”. Those users with a second hard drive in their Tivo should set the “diskBpresent” variable (2.1.4) in the configuration file. This allows for better presentation of SMART information.

• Added a "freepages" memory allocation fix for users struggling with memory problems. This is selectable through setting the “freepagesadjustment” variable in the configuration file (2.3.2)

• In order to help fix issues with broken pipes and email send crashes, incorporated a new option to break up the message into chunks rather than sending all at one time. This is selectable through setting the “fragmenthtmlemailwrite” variable in the configuration file (2.3.3).

• Added ability to re-size width of the email. This is selectable through setting the “programbarwidthpercent” variable in the configuration file (3.1.15).

• Modified module so that up to 3 recipient emails can be specified in the configuration file:

• “recipient” (2.2.3a)

• “recipient2” (2.2.3b)

• “recipient3” (2.2.3c)

• Added the ability to use either an AUTH LOGIN or AUTH PLAIN email server authentication method. This is selectable through setting the “authmethod” variable in the configuration file (2.2.6.1).

• Added a checkbox based multi-delete capability in the “To Do” list. This is selectable through setting the “todomultidelete” variable in the configuration file (3.4.4).

• Added a drop-down-list-box based multi-thumb update capability in the “To Do” list. This is selectable through setting the “todomultithumbupdate” variable in the configuration file (3.4.6). This is only available in series 1 TiVos.

• Added the ability to repeat the submit “buttons” for “multi” capability. This is selectable through setting the “multirepeat” variable in the configuration file (3.4.7).

• Added capability to display a dated subject line on the email if required. This is selectable through setting the “datedsubjectreq” variable in the configuration file (3.10.1).

• Added in connectivity with Sanderton’s tracker module - with highlights of blocked programs and pre-selection of delete checkboxes where possible. This is selectable through setting the “trackerblockreq” variable in the configuration file (3.4.5).

• Significantly modified space bar in the bulletin area to show expired items and suggestions as a separate grey line if required. This is selectable and fully configurable through setting a variety of variables in the configuration file:

• Specify whether suggestions are treated as free or used space: “countsuggestionsasfreespace” (3.1.15a)

• Specify whether expired items are treated as free or used space: “countexpiredasfreespace” (3.1.16b)

• Specify how suggestions are treated when they expire: “expiredsuggestionstreatment” (3.1.15)

• Show the remaning time in user defined units: “displayremainingtime” (3.3.6).

• Added in an optional suggestion graphic for the “To Do” and “Conflict” lists. This is selectable through setting the “suggestiongraphicreq” variable in the configuration file (3.1.17).

• Ability to provide external logging (2.3.5)

• Added optional start and end padding graphics for the “To Do” list. This is selectable through setting the “paddinggraphicsreq” variable in the configuration file (3.4.10).

• Significantly modified the “To Do” list to show cumulative , or progressive, space used. Where appropriate, this capability adds back in space for expired items to predict space available. This is a fully customizable area which includes:

• User selectable display of:

• Program length in minutes:

• “progstatusdurationreq” (3.4.8a)

• Program size in megabytes

• “progstatuspacereq” (3.4.8b)

• Remaining % disk space after program recorded

• “progstatuspercentageusedreq” (3.4.8c)

• Remaining time after program recorded

• “progstatustimeremainingreq” (3.4.8d)

• User selectable display of high-space indicator: “proglevelhighspaceindreq” (3.4.9).

• User selectable choice of basic, medium, high or best time remaining units: “remainingtimeunits” (3.1.14).

• User selectable display of indicator showing space added-back to expiry of programs: “showspaceaddedbackicon” (3.4.11)

• User selectable display of indicator showing that expired programs and suggestions will be deleted by TiVo to make recording space: “deleteforroomicon” (3.4.12)

• Added support to run the “fakecall.tcl” module in-line. This is selectable through setting the “runfakecallmodule” variable in the configuration file (2.3.4).

• Added support for a configurable application running list. This is configurable through setting the “appsrunning” variable in the configuration file (3.8.3).

• Added support for a configurable cron list. This is configurable through setting the “cronlist” variable in the configuration file (3.8.4).

• Made file location for the get_space module configurable : “getspacelocname” (4.16).

• Added ignore capability for certain selection / presentation types : “ignorelist” (3.1.18)

• Added optional variable to show pop-up alter boxes for spaceguage and info icon : “popuptextrequired” (3.3.7).

• Added global blocklist functionality – linked to Kevin Reilly's Blocklist or "xlist" module – set by optional variable: globalblockreq (3.4.16)

• Ability (and graphics) to block or unblock from email set by optional variable: globalblockfunction (3.4.17)

• Ability to embed images in email: embeddedimages (2.2.8).

• Ability to dynamically find out your external ip address and use that ip address within any of the hyperlinks in the email. (2.3.4)

Take a look here to see an example of what a generated email looks like. Please note that I may using the embedded image functionality, in which case the images will not show in the browser generated version.

Here are some screen shots of the TiVoWeb module for handling multiple deletes and thumb changes I have created:

Proposed deletion of items:

Proposed update of thumbs for various items:

Actioned update of thumbs for various items:

v0.37

Small updates have been made to the baselined v0.36 beta version to create a v0.37 beta version - released 25th Feb 05. You may download it from here:

• v0.37 beta readme.

• v0.37 beta download.

Key changes include:

• Modified expiry section to:

• provide a "None" line item if nothing found - previously was blank

• provide correct links from "view details" and "edit recording" hyperlinks

• specify correct channel call signs

• Removed "re-order season passes" hyperlink

• Added mempool expansion capability

v0.35.6 & v0.36

There are two previous versions available. The most recent previous version available under my change control was 0.35.6 beta. You may download it from here:

• v0.35.6 beta readme

• v0.35.6 beta download.