Remove Legacy Kiosk Customizations (FileWave 15.3 and Later)

FileWave 15.3 replaced the earlier desktop Kiosk customization method. Use this page to identify legacy Filesets, fwGUI.qss, settings.ini, and custom icon files that may still be deployed, then stop those deployments and remove the obsolete files where appropriate.

The look of the FileWave desktop Kiosk was customized using Qt Style Sheets. You would have had to create a file named fwGUI.qss and deploy it to clients in the right location. Several icons were also customizable by placing your custom icon in the right place with the right file name. All of this can be deployed via a Fileset.

For the supported customization workflow, see Setting the Primary Color, Name and Logo in Kiosk/App Portal. For reboot-dialog application controls, see Applications Preventing Reboot (macOS/Windows).

Identify the legacy Fileset

fwGUI.qss — Earlier environments used a Fileset containing fwGUI.qss and optional icon files. Stop its deployment to FileWave 15.3 or later clients because these files no longer customize the current Kiosk. The legacy destination depends on the client operating system.

macOS

/usr/local/sbin/FileWave.app/Contents/Resources/fwGUI.app/Contents/custom

Windows

C:\Program Files\FileWave\custom (might be "Program Files (x86)", depending on the platform)

The changes will only be visible in the desktop Kiosk after the user logs out and logs in again.

Identify legacy menu bar and system tray settings

settings.ini -- contained generic kiosk ui settings. Especially important is that if hide_system_tray = false that you will end up with 2 icons for the Kiosk where one is the old Kiosk if you are on FileWave 15.3.

Example

window_title = "Your New Window Title"
show_top_downloads = true
hide_system_tray = false

• The "window_title" attribute was displayed in the menu bar menu item - as well as in the kiosk window title area.

• The "show_top_downloads" attribute was used to hide the top downloads UI on a per client basis.

• "hide_system_tray" determined whether or not there will be an icon displayed in the system tray.  Setting 'false' will force the Kiosk to show even with no current association.

  Legacy Fileset examples
  These downloads can help identify Filesets that may still deploy the old settings:
  Windows (64) - Kiosk_Customizer_for_Windows64.fileset.zip
  Windows (32) - Kiosk_Customizer_for_Windows32.fileset.zip
  macOS - Kiosk_Customizer_for_macOS.fileset.zip
  macOS/Windows - Applications Preventing Reboot

Identify legacy custom icons

You might have included icon files that you used to replace them in Kiosk before 15.3. These icons will not appear in 15.3 or newer.

File name	Description	Example	Pixel Size
action_back.png	Icon for the "Back" action in the Software Installation dialog		48x48
action_forward.png	Icon for the "Forward" action in the Software Installation dialog		48x48
background_icon.png	Icon used for the watermark	(FileWave icon)	512x512
rating_star_half.png	Icon for half a rating star		40x40
rating_star_off.png	Icon for a rating star that is off		40x40
rating_star_on.png	Icon for a rating star that is on		40x40
tray_icon.png	System tray icon. If missing, the background_icon.png is used.	(FileWave icon)	16x16
warning.png	Warning icon, displayed when a fileset has problems (e.g. missing VPP user)		64x64

Related content

• Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)