Skip to main content

Setting the Primary Color and Logo in App Portal (15.3+)

What

This article provides step-by-step instructions on how to set a primary color and a logo for the Kiosk on FileWave v15.3.0+.

When/Why

The customization of the FileWave Kiosk interface, including its primary color and logo, allows organizations to maintain brand consistency across different platforms and devices. In order to make this change during the preview you will need direct access to your FileWave Server or have Technical Support make the edit for you. 

How

  1. Logo Customization:

  • Copy the image you wish to use as the logo to the following location: /usr/local/filewave/django/static/kiosk2/images/image.jpeg

  • Edit the server-side file located at: /usr/local/filewave/django/filewave/settings_custom.py.

  • Add the following entry at the end of the script: KIOSK_LOGO_URL = 'https://fully_qualified_domain_name/filewave/static/kiosk2/images/image.jpeg'

  • Restart the server after modifying settings_custom.py

The supported formats of the logo are:

- SVG
- JPEG
- PNG
- GIF
- Animated GIF
- WebP
- Animated WebP
- BMP
- WBMP

In case the Logo isn’t preset by the user, or if it's preset but cannot be retrieved for some reason, the default logo that will be shown in the application is the FileWave logo.

To ensure optimal display quality and prevent upscaling issues, we recommend using either:

  • SVG file format
  • Picture format with a minimum height of 96 pixels
  1. Primary Color Customization:
  • In the same server-side file mentioned above (/FileWave/Django/filewave/settings_custom.py), add the following entry at the end of the script: KIOSK_PRIMARY_COLOR = “#ColorCode“.
  • Restart the server after modifying settings_custom.py

Please note that the primary color should be written in a hex format of 6 or 8 characters. For example:

- KIOSK_PRIMARY_COLOR = '#e580ff'
- KIOSK_PRIMARY_COLOR = '#FF0000CC'

In case the default color isn’t preset by the user, or if it's preset but in the wrong format, the color that will be shown in the application is the FileWave default color.

If you encounter any issues with this process, we recommend opening a support ticket.

Please note that the details for the best size and format for logos and the exact color codes are subject to change and should be confirmed before implementation. The formats and color codes mentioned above are placeholders and will need to be replaced by the appropriate ones when decided.

Back to top