General & Appearance

Customize the general look and feel of Noctalia shell.

General

These settings are mostly found in the User interface tab in the settings window. Settings from the Lock screen tab are also included here.

"general": {
  "avatarImage": "",
  "dimDesktop": true,
  "showScreenCorners": false,
  "forceBlackScreenCorners": false,
  "scaleRatio": 1.0,
  "radiusRatio": 1.0,
  "screenRadiusRatio": 1.0,
  "animationSpeed": 1.0,
  "animationDisabled": false,
  "compactLockScreen": false,
  "lockOnSuspend": true,
  "language": ""
}

Settings	Default	Options	Description
avatarImage	""	string of the avatar image path	Your profile picture that appears throughout Noctalia interface.
dimDesktop	true	boolean	Dim the desktop when panels or menus are open.
showScreenCorners	false	boolean	Display rounded corners on the edge of the screen.
forceBlackScreenCorners	false	boolean	Use solid black instead of the bar background color.
scaleRatio	1.00	0.80 to 1.20 with 0.05 steps	Changes the size of the general user interface, excluding the bar.
radiusRatio	1.00	0.00 to 1.00 with 0.01 steps	Controls the corner roundness of windows, buttons, and other elements.
screenRadiusRatio	1.00	0.00 to 2.00 with 0.01 steps	Adjust the rounded corners of the screen.
animationSpeed	1.00	0.00 to 2.00 with 0.01 steps	Adjust global animation speed.
animationDisabled	false	boolean	Disable all animations for a faster, more responsive experience.
compactLockScreen	false	boolean	Show only the login input and system controls, hiding weather and media widgets.
lockOnSuspend	true	boolean	Automatically lock the screen when suspending the system.
language	""	See note on language	Select the language used in the Noctalia’s interface.

Note on language:

If the setting is left blank (""), Noctalia will automatically detect your system’s language and apply the corresponding translation, if one is available.

To manually configure the language, set the value to one of the supported languages:

• English: "en"
• German: "de"
• Spanish: "es"
• French: "fr"
• Portuguese: "pt"
• Chinese (Simplified): "zh-CN"

New languages can be found and added in Translations directory of the Noctalia shell Github repository.

UI

These settings are mostly found in the General tab in the settings window.

"ui": {
  "fontDefault": "Roboto",
  "fontFixed": "DejaVu Sans Mono",
  "fontDefaultScale": 1,
  "fontFixedScale": 1,
  "tooltipsEnabled": true,
  "panelsOverlayLayer": true
}

Settings	Default	Options	Description
fontDefault	"Roboto"	String of the name of an installed font.	Main font used throughout the Noctalia interface.
fontFixed	"DejaVu Sans Mono"	String of the name of an installed font.	Monospaced font used for numbers and stats display.
fontDefaultScale	1.00	0.75 to 1.25 with 0.01 steps	Increase or decrease the size of the standard text.
fontFixedScale	1.00	0.75 to 1.25 with 0.01 steps	Increase or decrease the size of the monospaced text.
tooltipsEnabled	true	boolean	Enable or disable tooltips throughout the interface.
panelsOverlayLayer	true	boolean	Panels will appear above fullscreen windows.