Domoticz: give a facelift by customizing the icons

Table of Contents

Icons included by default in Domoticz are a little old and do not always meet our needs. Fortunately it is possible to customize some of them quite simply. This method applies to the following devices: Media Player and ON / OFF

How to create new icons for Domoticz

Domoticz didn’t need a specific icons file. Domoticz manages just two States (ON / OFF) from 2 images. You can retrieve images from another Open Source automation software files or prepare your own. To simply create new icons, the easiest is to start from a design in a vector format (SVG). For example on the website Flaticon you can find very many files vector available for free (as long as you quote the author!). You can also take a look on the side iconfinder.

Here is what one finds for example with the key word garage door (and Yes, it will a do a little Google transat to find the right keywords). I selected the two icons on the second line. The closed door is checked.

flaticon recherche

Now, open the cart in the upper right. Click Download collection

Choose SVG

flaticon domoticz icone format svg

If you quote the author of icons, you can download them for free.

flaticon free download domoticz

The download starts immediately after (my-icons-collection). After decompression, go to the svg directory to find the recovered icons.

Now we can personalize them with a vector drawing software. If you do not, there are several Open Source and free. The easiest is the drawing of free Office module ( ). Inskscape ( is also a very good choice if you want to get into more complex icons.

Launch Libre Office and open a new drawing. Open the vector image (svg file). For example, I created on a first page one OFF with a Green State wording FARM and on a second page a State WE (OPEN label).

domoticz icone personnalisee libreoffice dessin vectoriel

Now we can export these two images in PNG format (file-> Export…)

domoticz icone export icone png on off

Give a file name and respect the formalism of Domoticz for each State ON and OFF (48_On and 48_Off).

domoticz icone export png nom fichier

In the selection list, choose Pixels and enter 48. Finish with OK.

domoticz icone export png 48x48 pixels

Open a FTP connection (read this article if you do not know how) and drop the two files in the directory domoticz /www/images.

domoticz icone transfert images icones ftp filezilla

Install new icons on a server Domoticz

Now that we have our new icons, it is to install and configure Domoticz to use them. Open a SSH connection or connect you to your Domoticz directly on the Raspberry.

Let’s start by editing the file switch_icons.txt , which is located in the directory www folder domoticz

 sudo nano domoticz/www/switch_icons.txt

the configuration file looks like this. It for 19 default icons.

Light;Light/Switch;A Lamp or Switch
WallSocket;Wall Socket;Power Wall Socket
TV;Television;Television Screen
Harddisk;Hard disk;Hard disk drive
Amplifier;Amplifier;Device that controls audio
Computer;Computer Laptop;Personal Computer System
Fan;Fan;Airflow Producer
Speaker;Speaker;Audio Speaker
Generic;Generic;Generic On/Off switch
Media;Media Player;Multi Media player
ChristmasTree;Christmas Tree;Christmas Tree
Heating;Heating;Heating device
Cooling;Cooling;Cooling device
ComputerPC;Computer PC;Personal Computer System
Phone;Phone;Mobile Phone

Each line corresponds to an icon. The line includes 3 names:

  1. the name of the image file by removing (48_On.png or 48_Off.png)
  2. the wording of the icon (shown in bold)
  3. a sub-caption (an optional additional information)

note. You can take the opportunity to translate the labels of the icons by the way

Best is to declare your personal icons at the end of the list. Domoticz built the selection list by sorting alphabetically labels of the configuration file. Save the file with Ctrl + X then O (or Y).

Add a new line of declaration of the garage icon

 Garage; Garage; Door

we restart the Domoticz service to take into account the new configuration file.

 sudo service restart

Also refresh the browser.

Edit now a device, a type switch On / OFF. In the list of choices, you will find your new icon. Save the change.

domoticz choix icone personnalisee

And here, your device is now customized. To get a better look, it is best to make icons with a transparent background.

domoticz icone affichee

Other sources of Open Source icons

Click to rate this post!
[Total: 0 Average: 0]

Thanks for your reading

Did you like this project ? Don't miss any more projects by subscribing to our weekly newsletter!

Are you having a problem with this topic?

Maybe someone has already found the solution, visit the forum before asking your question
We will be happy to hear your thoughts

Leave a Reply

Read more
Recent posts on the Forum
Top offers
DIY Projects
DIY Projects