Saltar al contenido principal

window

width​

Define the initial window width.

  • Default: 600

Example:

[window]
width = 600

height​

Define the initial window height.

  • Default: 400

Example:

[window]
height = 400

mode​

Define how the window will be created

  • Windowed (default) is based on width and height
  • Maximized window is created with maximized
  • Fullscreen window is created with fullscreen

Example:

[window]
mode = "Windowed"

opacity​

Set window background opacity.

  • Default: 1.0.

Example:

[window]
opacity = 0.5

blur​

Set blur on the window background. Changing this config requires restarting Rio to take effect.

  • Default: false.
[window]
blur = false

background-image​

Set an image as background.

  • Default: None

decorations​

Set window decorations.

  • Enabled (default for Windows/Linux/BSD) enable window decorations.
  • Disabled disable all window decorations.
  • Transparent (default for MacOS) window decorations with transparency.
  • Buttonless remove buttons from window decorations.

Example:

[window]
decorations = "Enabled"

Using blur and background opacity:​

[window]
opacity = 0.5
decorations = "enabled"
blur = true

Demo blur and background opacity

Demo blur and background opacity 2

Using image as background:​

If both properties width and height are occluded then background image will use the terminal width/height.

[window.background-image]
path = "/Users/hugoamor/Desktop/musashi.png"
opacity = 0.5
x = 0.0
y = -100.0

Demo image as background

If any property width or height are used then background image will be respected.

[window.background-image]
path = "/Users/hugoamor/Desktop/harvest-moon.png"
width = 1200
height = 800
opacity = 0.5
x = 0.0
y = 0.0

Demo image as background

MacOS: Unified titlebar​

You can use MacOS unified titlebar by config, it's disabled by default.

[window]
macos-use-unified-titlebar = false

Demo unified titlebar

MacOS: Enable or disable shadow​

You can enable window shadow on MacOS by config, it's disabled by default.

[window]
macos-use-shadow = true

Windows: Corner Preference​

Describes how the corners of a Microsoft Windows window should look like.

Options: Default, DoNotRound,Round and RoundSmall

[window]
windows-corner-preference = "Round"

Windows: Undecorated shadow​

Microsoft Windows specific.

Shows or hides the background drop shadow for undecorated windows.

[window]
windows-use-undecorated-shadow = false

Windows: use-no-redirection-bitmap​

Microsoft Windows specific.

This sets WS_EX_NOREDIRECTIONBITMAP.

[window]
windows-use-no-redirection-bitmap = false