Warp documentation
  • 🚀Getting Started
    • Quickstart Guide
    • What is Warp?
    • Migrate to Warp
    • Using Warp with [zsh|bash|fish|pwsh]
    • Privacy
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
    • Changelog
  • 🎨Appearance
    • Themes
    • Custom Themes
    • Prompt
    • Input Position
    • Text, Fonts, & Cursor
    • Size, Opacity, & Blurring
    • Pane Dimming & Focus
    • Blocks Behavior
    • Tabs Behavior
    • App Icons
  • 📕Features
    • Warp AI
      • Active AI
      • Agent Mode
      • Generate
      • Model Context Protocol
      • Voice
      • Rules
    • Command Palette
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Teams
    • Session Sharing
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
    • Accessibility
    • Find
    • Files, Links, & Scripts
    • Markdown Viewer
    • Working Directory
    • Smart-Select
    • Full-screen Apps
    • Keyboard Shortcuts
    • Notifications & Audible Bell
    • Settings Sync (Beta)
    • Quit Warning
    • Integrations
    • URI Scheme
    • Network Log
    • Secret Redaction
    • Linux
  • 📊How Does Warp Compare?
    • Performance
    • Terminal features
  • ❓Help
    • Sending Feedback & Logs
    • Plans, Subscriptions & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • How to use it
  • Window Size
  • Window Opacity
  • Window Blurring
  • How it works
  • Troubleshooting transparency on Windows

Was this helpful?

  1. Appearance

Size, Opacity, & Blurring

Warp supports settings for Window size, opacity(transparency), and blurring effects. This can help with setting up specific terminal layouts and visual preferences.

PreviousText, Fonts, & CursorNextPane Dimming & Focus

Last updated 2 months ago

Was this helpful?

How to use it

Window Size

To access size settings, go to Settings > Appearance > Window.

  • Enable "Open new windows with custom size", Then configure your preferred columns and rows.

If is enabled, Warp will restore the size of the last window closed when you quit the app. Either make sure the custom-sized window is the last one closed, or disable Session Restoration to ensure Warp launches with the custom-sized window.

Window Opacity

To access it, go to Settings > Appearance > Themes

  • The slider supports setting the opacity value between 1 and 100 where 100 is completely opaque or solid.

Window Blurring

After decreasing Opacity (moving the slider to a value less than 100), you can also blur the background.

  • On MacOS, this is done using the blur slider. Increasing the slider increases the blur radius that's applied to the background image.

  • On Windows, this is done by toggling the Acrylic background texture on or off.

On macOS, large blur radiuses may affect performance, especially on Retina displays.

On Linux, window blurring is not supported.

On Windows, some graphics drivers may not support rendering transparent or translucent windows. See below for troubleshooting tips.

How it works

Troubleshooting transparency on Windows

At the moment, window opacity in Warp on Windows does not work in the following circumstances:

  • When using DirectX 12 as the rendering backend

  • When using any rendering backend with an Nvidia GPU when "Auto" or "Prefer layered" is selected as the value for "Vulkan/OpenGL present method" in NVIDIA Control Panel > Manage 3D Settings

Some graphics drivers and rendering backends may not support rendering transparent windows.

You can select the Vulkan or OpenGL graphics backend to render new Warp windows in the Settings menu, under Features > System > Preferred graphics backend.

You can also opt to render new Warp windows with an integrated GPU, under Features > System > Prefer rendering new windows with integrated GPU (low power).

🎨
Session Restoration
Window Opacity and Blurring Demo
Window Size Demo
Window Size Demo