Settings reference
Every key in AltTabSettings.ini, which sits beside AltTab.exe. The file can be edited by hand — AltTab notices it changing and reloads it — or through the Settings dialog, which is the same thing with explanations attached. The dialog's Advanced page lists all of these too, including the few that have no control of their own.
Colours are 0xRRGGBB. Booleans are 1 or 0. Hotkeys are written the way they read: Ctrl+Alt+Tab.
This page is generated by
Scripts/make_settings_reference.pyfrom the INI the application itself writes and fromATSettingDescriptors()insource/AltTabSettings.cpp. Do not edit it by hand; run the script.
[Hotkeys] — Hotkeys
| Key | Type | Default | What it does |
|---|---|---|---|
AltTabEnabled | Boolean | 1 | Whether the switch-between-all-windows hotkey is active. |
AltBacktickEnabled | Boolean | 1 | Whether the switch-within-one-application hotkey is active. |
AltCtrlTabEnabled | Boolean | 1 | Whether the stay-open hotkey is active. |
AltTab | Hotkey | Alt+Tab | The combination that switches between every window. Needs at least one of Ctrl, Alt or Shift. |
AltBacktick | Hotkey | Alt+Oem3 | The combination that cycles the windows of one application. |
AltCtrlTab | Hotkey | Ctrl+Alt+Tab | The combination that opens the switcher and leaves it open when the modifiers are released. |
[SearchString] — Search box
| Key | Type | Default | What it does |
|---|---|---|---|
CueBannerText | Text | Search windows by title or process name... | The placeholder shown in the search box while it is empty. |
FontName | Text | Lucida Handwriting | Font the search box draws with. |
FontSize | Integer | 11 | Search box font size, in points. |
FontStyle | Text | normal | normal, italic, semibold, semibold italic, bold or bold italic. |
FontColor | Color | 0xFFFFFF | Search box text colour. |
BackgroundColor | Color | 0x2B2B2B | Search box background colour. |
[ListView] — Window list
| Key | Type | Default | What it does |
|---|---|---|---|
FontName | Text | Lucida Handwriting | Font the window list draws with. |
FontSize | Integer | 11 | Window list font size, in points. |
FontStyle | Text | normal | normal, italic, semibold, semibold italic, bold or bold italic. |
FontColor | Color | 0xFFFFFF | Window list text colour. |
BackgroundColor | Color | 0x1F1F1F | Window list background colour. |
HighlightTextColor | Color | 0x4CC2FF | Colour of the letters your search matched. |
HighlightBackgroundColor | Color | 0x434343 | Background behind the letters your search matched. |
NotRespondingBackgroundColor | Color | 0x52252C | Background for a row whose window is not responding, on Fonts and Colors. A theme derives its own instead. |
SelectedBackgroundColor | Color | 0x316179 | Background of the selected row. Picking a theme loads its own into this. The text on the row is chosen for you, black or white, so a pale colour cannot leave it unreadable. |
SelectedOutlineColor | Color | 0x4CC2FF | The frame drawn around the selected row. Absent from the file, it is derived from the theme's accent and the selected background — which is what every built-in palette resolves to. |
HoverOutlineColor | Color | 0x5D6F78 | The frame drawn around the row under the pointer, shown when [MouseHover] ShowHighlightRect is on. Absent from the file, it is derived from the selected row's colour at half strength. |
BoldMatchedText | Boolean | 1 | Draw the letters your search matched in bold as well as in the matched colors. On many themes the accent is close in brightness to the title text, so weight is what makes a match visible. |
[General] — General
| Key | Type | Default | What it does |
|---|---|---|---|
PromptTerminateAll | Boolean | 1 | Ask for confirmation before closing or terminating every window. |
FuzzyMatchPercent | Integer | 60 | How close a match counts, 1-100. 100 means exact substring matching only; lower values let files match filas. |
RowCloseAnimationMs | Integer | 100 | How long a row takes to fade and slide out when its window is closed, 0-1000. 0 removes it at once. |
WindowTransparency | Integer | 222 | 0-255. 255 is opaque; the default 222 is slightly translucent. Below 255 the switcher is a layered window, which changes how rounded corners are drawn. |
WindowWidthPercentage | Integer | 45 | Switcher width as a percentage of its monitor's width. |
WindowHeightPercentage | Integer | 45 | The most of its monitor's height the switcher may use. It is only ever as tall as the rows it has. |
ShowSearchString | Boolean | 1 | Show the search box at the top of the switcher. |
KeepOpenWhileTyping | Boolean | 0 | Off by default. Off, releasing the hotkey activates the selected window whether or not you have typed. On, the switcher stays up once there is search text and waits for Enter, a click or Escape. |
RoundedCorners | Boolean | 1 | Round the switcher's corners, radius 8. |
ShowColProcessName | Boolean | 0 | Show the process-name column. |
CheckForUpdates | Choice | Startup | Startup, Daily, Weekly or Never. |
UpdateChannel | Choice | Stable | Stable, Stable (delayed 1 week) or Developer. Stable offers released versions only, and the delayed form waits until a release is a week old so that other people meet a bad one first. Developer also offers pre-releases. To stop checking at all, set CheckForUpdates to Never. Nothing is installed without asking. |
CrashReporting | Choice | Always | Whether a crash is reported to the project's Sentry. Never initialises nothing and opens no connection; Always (the default) sends the call stack, the module list and the version when AltTab crashes. No memory dump, so no window titles, file paths or search text, and no machine or user name. See PRIVACY.md. |
SwitcherMonitor | Choice | Cursor | Which monitor the switcher opens on: Cursor, ActiveWindow or Primary. |
PreviewPlacement | Choice | Auto | Where the live preview switcher sits while the Settings window is open: Auto puts them on separate monitors when there are two, SameMonitor stacks them on the Settings window's own monitor, and OtherMonitor keeps them apart wherever it can. Stacked is what a screenshot of both needs; apart is what makes the size and centring settings worth judging. |
SystemTrayIconEnabled | Boolean | 1 | Show AltTab's icon in the notification area. |
Theme | Text | Dark | The theme whose colours are loaded. One of the built-in palettes, or one of your own from a [Theme.<Name>] section. Default is AltTab's own colours. |
UseThemeColors | Boolean | 0 | A one-shot instruction, not a setting you leave on: set it to 1 and the theme named above is loaded into the colour settings the next time AltTab reads this file, and the key is cleared. That is how a file written by an older build keeps looking the same. |
[MouseHover] — Mouse
| Key | Type | Default | What it does |
|---|---|---|---|
ShowProcessInfoTooltip | Boolean | 1 | Show the information tooltip when the pointer rests on a row. |
ShowHighlightRect | Boolean | 1 | Outline the row under the pointer. |
ShowDeleteButton | Boolean | 1 | Show a close button on the row under the pointer. |
TooltipDelayMs | Integer | 100 | How long the pointer must rest before a tooltip appears, 0-5000. |
BoldTooltipLabels | Boolean | 1 | Draw the tooltip's labels in bold, on the Mouse page. The values beside them keep the ordinary weight unless BoldTooltipValues is on. |
BoldTooltipValues | Boolean | 0 | Bold the values in the row tooltip as well, not only the labels. Off by default: the two-column table reads well precisely because one column is heavier than the other. |
[Backtick] — Switching within an application
| Key | Type | Default | What it does |
|---|---|---|---|
SimilarProcessGroups | Text | notepad.exe/notepad++.exe|iexplore.exe/msedge.exe/chrome.exe/firefox.exe|explorer.exe/xplorer2_lite.exe/xplorer2.exe/xplorer2_64.exe|cmd.exe/WindowsTerminal.exe/conemu.exe/conemu64.exe | Applications treated as one for switch-within-an-application. Groups are separated by |, executables within a group by /. The groups are mutually exclusive: an executable can be in only one of them. If the same name appears twice, the first group keeps it and the later one loses it — and a group left with fewer than two names is dropped, since it cannot group anything. |
[ProcessExclusions] — Hidden applications
| Key | Type | Default | What it does |
|---|---|---|---|
Enabled | Boolean | 0 | Whether the list below is applied. |
ProcessList | Text | (empty) | Executables whose windows are hidden from the switcher, separated by /. |