event-osd

event-osd is a notification system for the WDTV that enables your application to modify the GUI on the fly. This is done my hooking into the osd files that are accessed and observing which files are loaded by the OSD application. In case a file that is used to display a list of files is opened event-osd determines the corresponding path and passes everything to a script that may modify the OSD XML files for the current directory.

Download the latest application image for the WDTV or the source code.

Tutorial

A tutorial to introduce you to the usage and concepts of event-osd is available at event-osd/tutorial.

Documentation

• app.event config file format

Used By

The following applications use event-osd:

To add your application simply edit this page (you need a sourceforge Account), or send a link to wdtv(AT)elmarweber.org.

• appletrailerfs
• Weecommand A powerfull way to browse a file list on your tv and download what you like pressing 'Enter'

Best Practices

• Assume nothing about the XML files you find because some user may be using another theme than you or other images. The file may even be modified by another script before your script is called in case there are several listeners for one path.
• Restore the files you modify. So if you change basic_browse.xml call another script at the end of your primary script that restores the original file with a delay of say two seconds. This way everything works when the user opens a directory that is not managed by your script
• Be fast, waiting on a directory change, an operation that is inherently fast, is nerving for the user. There are several things you can do to speed up your script:
  • if you create a backup of any files you modify copy them to /tmp or another directory that is in memory, so can be accessed fast
  • if possible create link of files instead of copying them
  • cache and pre create as many things as you can before your script is called, for example for appletrailerfs all XML files are created beforehand and just linked when the script is called

Example