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 |