View source for DLNA Media Server Virtual Appliance

== Introduction ==

A DLNA[1] Media Server is a device that stores media content that can be accessed by media players and  rederers found in the same local network. The goal was creating a minimal solution to meet theese requirements. This was achieved using the tools provided by the yocto project through the creation of the meta-dlna layer.

== Package dependencies ==

The solution was build around rygel[2], an application used for media content sharing on a home network. Rygel implements its functionality through a plugin mechanism. A solution provided by Tracker. An alternative solution is uses the MediaExport plugin which exports files and folders over the network. This was preffered because it represents a more lightweight solution.

== How to integrate DLNA to a poky distribution ==

The meta-dlna layer was created using the combo-layer tool[3]. To use it follow the next steps:
* Copy the <tt>meta-dlna</tt> folder into the root directory of a <tt>poky</tt> distribution. <tt>Cd</tt> into the poky folder.
* Add the layer to <tt>build/conf/bblayers.conf</tt>:
 [...]
 BBLAYERS="
          $POKY_HOME/meta-dlna/meta-guacamayo
 [...]

* Add some extra features to <tt>build/local.conf</tt>:
 [...]
 DISTRO_FEATURES = "ext2 largefile usbhost xattr nfs zeroconf pci ${DISTRO_FEATURES_LIBC} x11" 
 [...]

* source the oe-init-env script
* build the image using the guacamayo-image-mediaserver target
 bitbake <tt>guacamayo-image-mediaserver</tt> [TODO] 
For testing purposes, demo content can be added by inserting the following line to <tt>build/conf/local.conf</tt>:

 [...]
 IMAGE_FEATURES_append = " guacamayo-demos"
 [...]