Skip to content

Custom system image

Anders Nylund edited this page Mar 3, 2017 · 7 revisions

The system image is an svg file (vector image) that can be edited with any svg capable vector drawing program, for instance the excellent and free inkscape.

To make your own image it's easiest to start by copying one of the provided default images (system*.svg) and modify it, then set thesystem_image setting in the [conf] section in the configuration file /etc/pellmon/conf.d/webinterface.conf to the absolute path of the modified image. The modified image can be anywhere as long as the pellmonweb system user has read rights, for instance in the home folder.

The data readings in the image are normal text objects that that have been tagged with an id in the form paramname:parameter, where 'parameter' is the name of the data to insert into the picture. The web application scans the image for these tags and creates a websocket connection to your pellmon webserver that keeps them updated in realtime. This means that any available data can be inserted into the picture with any font, size, color and orientation desired. Tagging a text with a parameter name is as simple as right clicking it in inkscape, selecting 'object properties', and filling out the 'Id' field in the dialog box (remember to click the 'Set' button to make the change stick):

You might have to reload the web page in your browser (ctrl-F5 in chrome/firefox) to get the new system image, otherwise your browser might still be showing you the old one from it's cache.