Customizing Kando

You can customize Kando in many ways. This page will show you how to add your own icons to Kando and how to install new themes.

Menu Themes

Kando supports theming the menu. Themes use CSS to style the menu and can change the look of the menu drastically. Kando comes with a few themes pre-installed. You can find more themes in the Kando Menu Themes Repository! Below are some examples of themes:

Clean Circle

One of Kando’s default themes.

Neon Lights

One of Kando’s default themes.

Minecraft

This is one of the community themes from the Kando Menu Themes Repository.

Rainbow Labels

One of Kando’s default themes.

Do you want to create your own themes?

There’s a guide on how to create your own themes available!

Icon Themes

Kando also supports custom icon themes. An icon theme is a set of icons which can be used for the menu items. Kando comes with a few icon themes pre-installed and you can easily add your own. To add your own icons to Kando, follow these steps:

1. Create a new icon-themes directory in Kando’s configuration directory if it does not yet exist. Depending on your OS, this will be the following locations:

   Windows

   %appdata%\kando\icon-themes

   macOS

   ~/Library/Application Support/kando/icon-themes

   Linux

   ~/.config/kando/icon-themes

2. Create another directory for your icon theme inside the icon-themes directory. You can give it any name you like.

3. Add your icons to the new directory. The icons can be in various formats, but we recommend using SVG files.

   Tip

   You can organize your icons in subdirectories. Kando will load them recursively.

4. Restart Kando. Icon themes are only loaded when Kando starts.

5. Select your icon theme in the icon-theme dropdown in the icon picker in Kando’s menu editor.

Danger

Kando will also load icon themes from resources/app/.webpack/renderer/assets/icon-themes/ in the installation directory. This can be interesting if you are packaging icon themes using a package manager. However, as an end user, you should not put your icon themes there, as they might be overwritten during an update.

Suggestions for Icon Sets

There are many great icon sets available on the internet. Here are some which you could try:

• Numix Circle: Just use the files from the Numix-Circle/48/apps directory.
• Papirus: Here you could use the content from the Papirus/64x64 directory.
• Tela: Here you find the icons in the src/scalable directory.
• Pixelitos: Here you find the icons in the 16 directory.

Have you discovered another cool icon set?

Simply edit this page and add it to the list above!