microsoft / microsoft/terminal

Quake window responds poorly to `SW_MINIMIZE` coming through ConPTY

Open
#18,769 14 comments 2 reactions 0 assignees View on GitHub
Area-Windowing Issue-Bug Priority-3 Product-Terminal
Dominant language
C++
Stars
105k
Forks
9.6k
Avg merge
3d 17h
Merged PRs (30d)
29

Description

### Windows Terminal version

1.22.10731.0

### Windows build number

10.0.19044.0

### Other Software

_No response_

### Steps to reproduce

Start Windows Terminal with the following command: `wt.exe -w _quake pwsh -window minimized`

### Expected Behavior

The Terminal opens in Quake mode, then minimizes itself. No other windows appear on the screen.

### Actual Behavior

The Terminal does open in Quake mode, minimized. But then there is a very small (presumably empty) window in the bottom-left corner of the screen.

![Image](https://github.com/user-attachments/assets/a05dd5f1-24ee-4587-a5d3-5d419c8f2902)

This happens on both Windows 10 Enterprise LTSC and Windows 11 Pro. My assumption is that Terminal needs this window to exist, but it's supposed to be outside the screen boundary?

Contributor guide

Open the contributing guide

Research direction

First reproduce `wt.exe -w _quake pwsh -window minimized` on the reported Windows versions and trace how `SW_MINIMIZE` arriving through ConPTY is handled in Quake mode. Search the Terminal code for `SW_MINIMIZE`, ConPTY, and Quake window handling; done means minimizing leaves no small auxiliary window visible at the bottom-left of the screen.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
cli
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.