System Properties

Java system properties can be used to change some behavior of FlatLaf.

They can be either passed at command line to any application that uses FlatLaf:

$ myapp -Dflatlaf.animation=false

Or set in Java code:

System.setProperty( "flatlaf.animation", "false" );

List of system properties used in FlatLaf:

Property Name Description Allowed Values Default
flatlaf.uiScale Specifies a custom scale factor used to scale the UI. If Java runtime scales (Java 9 or later), this scale factor is applied on top of the Java system scale factor. Java 8 does not scale and this scale factor replaces the user scale factor that FlatLaf computes based on the font. To replace the Java 9+ system scale factor, use system property sun.java2d.uiScale, which has the same syntax as this one.
Since FlatLaf 1.1.2: Scale factors less then 100% are allowed.
e.g. 1.5, 1.5x, 150% or 144dpi (96dpi is 100%) none
flatlaf.uiScale.enabled Specifies whether user scaling mode is enabled. false and true true
flatlaf.useUbuntuFont Specifies whether Ubuntu font should be used on Ubuntu Linux. By default, if not running in a JetBrains Runtime, the Liberation Sans font is used because there are rendering issues (in Java) with Ubuntu fonts. false and true false
flatlaf.useWindowDecorations Specifies whether native window decorations should be used when creating JFrame or JDialog.
Setting this to true forces using native window decorations even if they are not enabled by the application. Setting this to false disables using native window decorations. This system property has higher priority than client property JRootPane.useWindowDecorations and UI default TitlePane.useWindowDecorations.
(requires Window 10)
false and true none
flatlaf.useJetBrains ↩ CustomDecorations Specifies whether JetBrains Runtime custom window decorations should be used when creating JFrame or JDialog.
Requires that the application runs in a JetBrains Runtime (based on OpenJDK).
Setting this to false disables using JetBrains Runtime custom window decorations. Then FlatLaf native window decorations are used.
(requires Window 10)
false and true true
flatlaf.menuBarEmbedded Specifies whether the menu bar is embedded into the window title pane if window decorations are enabled.
Setting this to true forces embedding. Setting this to false disables embedding.
This system property has higher priority than client property JRootPane.menuBarEmbedded and UI default TitlePane.menuBarEmbedded.
(requires Window 10)
false and true none
flatlaf.animation Specifies whether animations are enabled. false and true true
flatlaf.useTextYCorrection Specifies whether vertical text position is corrected when UI is scaled on HiDPI screens. false and true true