microsoft/terminal
1
0
Fork 0
mirror of https://github.com/microsoft/terminal.git synced 2025-12-10 18:43:54 -06:00
Code Issues Packages Projects Releases 138 Wiki Activity

Add FAQ, fill in with quake mode questions (since we're getting a lot of those)

Mike Griese 2021-05-27 09:52:11 -05:00
parent f0c4e11e73
commit ffd07507f2
1 changed files with 48 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
Frequently-Asked-Questions-(FAQ).md Normal file

@ -0,0 +1,48 @@
_last updated 27 May, 2021_
This page serves as a list of some of the more commonly encountered issues while using the Terminal.
### Quake Mode & Global Summon
Please make sure to check out #8888, which is tracking all the quake-mode and `globalSummon` related issues.
#### What is "Global Summon"
"Global Summon" refers to the `globalSummon` action. This action allows you to bind a shortcut _systemwide_ to activate the Terminal window. This means that you can bind something like <kbd>win+\`</kbd>, and press that _anywhere_ in the OS to instantly activate the Terminal window. `globalSummon` supports a ton of different parameters to control its behavior, so please make sure to [check out the docs](https://docs.microsoft.com/en-us/windows/terminal/customize-settings/actions#global-commands).
#### What is "Quake Mode"?
"Quake Mode" is a specific version of `globalSummon`. It summons a window that's named `_quake`, and the window named `_quake` has certain special properties. Check out [the docs](https://docs.microsoft.com/en-us/windows/terminal/tips-and-tricks#quake-mode) for more details.
#### I can't use the `quakeMode`/`globalSummon` keybinding unless I've already launched the Terminal
That's correct - the Terminal needs to be running to be able to register the global hotkeys. You can configure the Terminal to launch on machine startup with `"startOnUserLogin": true`. We're also using #9996 to track "Allow the Terminal to start up and process global hotkeys without creating a window".
#### How do I set the size of the `quakeMode` window?
Right now, you can't. The window named `_quake` will always open on the top half of the monitor.
What you _can_ do, though, is rebind <kbd>win+\`</kbd> to a different `globalSummon` action. The following will be equivalent to the `quakeMode` action, but without the requirement that the window's name is `_quake`:
```json
{ "keys": "win+`", "command": { "action": "globalSummon", "dropdownDuration": 200, "toggleVisibility": true, "monitor": "toCursor", "desktop": "toCurrent" } }
```
Then, your window will still obey your standard `initalPosition`, `initialRows`, etc. settings.
Additionally, #9992 is the issue we're tracking for "Allow configuring global settings per-window name". That means you'll be able to use that to change the settings for the window named `_quake`.
#### The `quakeMode` window doesn't have any tabs / How can I have tabs in the quake window
The `_quake` window always opens in ["focus mode"](https://docs.microsoft.com/en-us/windows/terminal/customize-settings/actions#toggle-focus-mode) by default. That doesn't mean that the quake window doesn't _have_ tabs, just that they're hidden. You can use the [Command Palette](https://docs.microsoft.com/en-us/windows/terminal/command-palette) to disable focus mode if you want to see the tabs again.
If you don't want the global hotkey to summon the window in quake mode, there are two options:
* Either re-bind it to a different `globalSummon` action, like the above, without `"name": "_quake"`.
* Wait patiently for #9992 to allow changing the settings of the `_quake` window name.
#### I want to use a different hotkey to summon different profiles
This is another scenario that'll have to wait for #9992. What you'd end up with is different window names for each profile you want a specific hotkey for. The `defaultProfile` for those windows would be set to whatever profile you want. Then, you'd bind `globalSummon` actions, with the `name` set to each of those window names.