Under the Hood: Customization

Overview

Passwords includes several customization features designed to support integration into corporate or professional environments.

Splash screen

You can provide a custom splash screen by placing a file named splash.png in the same directory as the Passwords executable. If this file is present, Passwords will display it instead of the default splash screen as the application starts.

Terms of Use Dialog

Passwords can display a Terms of Use or security notice before the application loads. To enable this feature, create a text file named conditions.txt in the same directory as the Passwords executable.

If this file is present, Passwords will show its contents in a dialog when the application starts. Users must acknowledge or accept the terms before they can proceed. If the file is not present, the application starts normally without displaying a dialog.

This feature allows organisations to present legal notices, usage policies, or security warnings without modifying the application itself.

Application Stylesheet

Passwords supports full visual customization through an optional external stylesheet. This allows organisations to apply their own branding, colour schemes, or accessibility‑focused themes without modifying the application itself.

To enable this feature, create a file named style.css and place it in the same directory as the Passwords executable. If this file is present, Passwords will automatically load and apply it at startup, overriding the built‑in default theme.

The stylesheet uses standard Qt Style Sheet (QSS) syntax, which is similar to CSS. You can customise fonts, colours, spacing, widget appearance, and more. This makes it possible to align Passwords with corporate identity guidelines or create high‑contrast themes for improved readability.

If style.css is not present, Passwords will fall back to its bundled default stylesheet.