Setting up MythNotify
MythNotify is an add-on program which sends notifications, like caller-id information, to a running mythfrontend.
How-To guide on setting up Mythnotify (callerid)
By Dennis Hand
modifications by Geoff Scott
troubleshooting by Jim Shank
I had heard of this feature some time ago but since I hardly knew Linux anyway I thought better of it. But now that I'm comfortable with it, here are a few instructions on getting it up and running.
Since I have compiled from source, Mythnotify resides in the contrib directory starting with version Mythtv-0.13. For anyone that has installed Mythtv using mythtv-suite, this can be found here /usr/share/doc/mythtv-0.18.1/contrib.
This is a nice little feature that allows you to see who's calling you while you're watching LiveTV. It simply pops up a rectangular box that has the name and phone number along with other miscellaneous information. The OSD font and number of seconds can be changed in the mythfrontend setup. Here's how you setup Mythnotify.
These are the dependencies that are required for Mythnotify. Chances are they have already been installed on your system.
First we need to be in the mythudprelay directory, e.g.:
Once there we need to compile this feature
No dependencies are needed here. Change directory to cidbcast, e.g.:
Compile this feature
The one problem I had was trying to figure out how to make these two features startup at boot. I came up with were two startup scripts that go into your Autostart folder of your desktop manager. That could be KDE or XfCE4 which is what I use. This is my path to Autostart.
Yours might be
Let's go ahead and make a file called callerid.sh and place it in our Autostart folder.
This is the contents of callerid.sh
Give it permissions of 0775 for user mythtv or whatever your username is. Now for the second file, lets call it osd.sh and place it in our Autostart folder as well. This is the contents of osd.sh
Same permissions as above.
The drawback to having your scripts in ~/.kde/Autostart is that they are only executed when a user logs in and opens a KDE session. I wanted MythNotify to start automatically on my backend server without any intervention. I found that the following lines work when added to /etc/rc.d/rc.local (Fedora/RedHat/CentOs):
/path/to/cidbcast --file=/path/to/cidbcast.xml --device=/dev/modemDevice --init='InitString' & /path/to/mythudprelay --xslfile /path/to/callerid.xsl --bcast='255.255.255.255' --udpport_in=6947 --udpport_out=6948 &
Of course replace "/path/to" with the actual location of your files (mine are in /usr/local/bin), and "modemDevice" and "InitString" with the appropriate values for your modem (mine are ttySHCF0 and AT+VCID=1 for a Conexant HCF modem).
Now that we can turn on-off the CallerID feature with the remote control, we now need to put callerid.sh into our PATH. This allows us to execute callerid.sh from anywhere by just giving it the filename rather than the entire path. Also we will be creating our on-off script to work with irexec. (note: Please note that I am using a newer version of QT so qt-3.2 in the command below reflects that. You may be using qt-3.1 so make sure you know what version you're running to add to your PATH. Also note that my last entry is the Autostart folder of my home directory. This is where my callerid.sh resides. Adjust yours to reflect your callerid.sh PATH).
To add another directory(s) to your PATH let's edit a file in your home directory under mythtv called .bash_profile. Where it says
change to something like this
This changes your PATH permanently. Restart X for the effects to take place
Now we need to build our on-off script. You can name this what you like. I've named mine callerIDtoggle.sh. Place this somewhere like /usr/local/bin
The last part to all of this is irexec. Before using this program, make sure it's running first. This could possibly be loaded into your rc.local file or your Autostart folder where mine is. This program will allow us to use our remote control to turn CallerID on and off, by way of our script, with just one button. The two files that we're after are .lircrc and lircrc(.lircrc maybe a symlink). These two files reside in your mythtv home directory. Just use your favorite text editor to make changes. Doesn't really matter where you put this in the file. Since I'm using the grey hauppauge remote, spare buttons are running out. I did have one available so I used the BLANK button for this. The info below will be added to both lircrc files.
begin prog = irexec button = BLANK config = /usr/local/bin/callerIDtoggle.sh end
The cidbcast program automatically defaults to com1, which is ttyS0. Make sure you have proper permissions set on ttyS0 in the /dev directory. If your using an internal modem this will default to another comport such as /dev/ttyS15 or possibly /dev/modem. If your having problems setting up your modem correctly use "./cidbcast --help" for more help. Once this has been all setup, give your computer a reboot to see if it works. You should see the TR(transmit receive) light come on, using an external modem, when your desktop splash screen comes up. This means the modem is ready to accept incoming calls.
I have an Agere/TRENDNet Modem that doesn't seem to follow the conventional output for caller ID. You can verify that you are getting data by running:
./cidbcast -v --file cidbcast.xml --init="AT S7=45 S0=0 L0 V1 X4 Q0 +VCID=1"
This will show you what data the modem is actually capturing and sending. In my case, cidbcast was unable to find the data in the caller id stream. Using Minicom, I found out the format of my caller id was:
DATE=0427 TIME=1153 NAME=SCHMOE,JOE NMBR=3035551212
What is expected by cidbcast is:
DATE = 0427 TIME = 1153 NAME = SCHMOE,JOE NMBR = 3035551212
I am not sure what the standard format is but a quick edit of the cidbcast.c to correct the fields:
if ( (field_ptr = extract_cid_field(buffer, len, "NMBR=", &field_len)) || (field_ptr = extract_cid_field(buffer, len, "CALLER NUMBER: ", &field_len)) )
- notice the removal of the space between the = and the label/data pairs.
make clean, make and retest as above to see if you got it right.