window_decorations = "TITLE | RESIZE"#

Configures whether the window has a title bar and/or resizable border.

The value is a set of flags:

• window_decorations = "NONE" - disables titlebar and border (borderless mode), but causes problems with resizing and minimizing the window, so you probably want to use RESIZE instead of NONE if you just want to remove the title bar.
• window_decorations = "TITLE" - disable the resizable border and enable only the title bar
• window_decorations = "RESIZE" - disable the title bar but enable the resizable border
• window_decorations = "TITLE | RESIZE" - Enable titlebar and border. This is the default.

The following flags are also supported on macOS:

• MACOS_FORCE_DISABLE_SHADOW - disable the window shadow effect
• MACOS_FORCE_ENABLE_SHADOW - enable the window shadow effect.

The window shadow effect is normally disabled by wakterm when the window_background_opacity is set to less than 1.0.

• window_decorations = "INTEGRATED_BUTTONS|RESIZE" - place window management buttons (minimize, maximize, close) into the tab bar instead of showing a title bar.

  See also integrated_title_button_style, integrated_title_buttons, integrated_title_button_alignment integrated_title_button_color and, if you are using the retro tab bar, tab_bar_style.

The following flags are also supported:

• MACOS_FORCE_SQUARE_CORNERS - on macOS, force the window to have square rather than rounded corners. It is not compatible with TITLE or INTEGRATED_BUTTONS
• MACOS_USE_BACKGROUND_COLOR_AS_TITLEBAR_COLOR - on macOS, change the system titlebar background color to match the terminal background color defined by your configuration. This option doesn't make sense to use without also including TITLE|RESIZE in the set of decorations.

On X11 and Wayland, the windowing system may override the window decorations.

When the titlebar is disabled you can drag the window using the tab bar if it is enabled, or by holding down SUPER and dragging the window (on Windows: CTRL-SHIFT and drag the window). You can map this dragging function for yourself via the StartWindowDrag key assignment. Note that if the pane is running an application that has enabled mouse reporting you will need to hold down the SHIFT modifier in order for StartWindowDrag to be recognized.

When the resizable border is disabled you will need to use features of your desktop environment to resize the window. Windows users may wish to consider AltSnap.

Think twice before removing RESIZE from the set of decorations as it causes problems with resizing and minimizing the window. You usually want to keep RESIZE enabled.

[!DANGER] If you just want to remove the title bar, set window_decorations = "RESIZE" as you will run into problems if you remove RESIZE from the set of decorations.

[!TIP] You probably always want RESIZE to be listed in your window_decorations.