Flags - bakkeby/dusk GitHub Wiki
The term Flag in the context of this window manager refers to features that can be enabled on a
per window basis via client rules.
The idea of flags stems from the many patches for that introduce new rule options, often storing a new value in the Client struct.
One example of this is the swallow patch which adds
two new int values of isterminal and noswallow both to the rules list and the Client struct.
Instead of having multiple boolean values (iscentered, isfloating, isfakefullscreen, etc.)
one could instead have a single unsigned long value that could hold up to 64 flags (one flag per
bit). That is exactly what flags do and this makes it easier to set up rules.
Example rule combining Floating and SwitchWorkspace flags:
static const Rule clientrules[] = {
...
{ .class = "Gimp", .workspace = "5", .flags = Floating|SwitchWorkspace },
...Client flags can also be changed externally using the toggleclientflag function.
Below is the list of available flags:
| Flag | Description | Topic |
|---|---|---|
| AttachMaster | Attach at the top of the master area | Attach |
| AttachAbove | Attach the client before the currently selected client | Attach |
| AttachBelow | Attach the client after the currently selected client | Attach |
| AttachAside | Attach at the top of the stack area | Attach |
| AttachBottom | Attach at the bottom of the stack area | Attach |
| CfgReqPosRelativeToMonitor | Treat x,y position of configure requests as being relative to the monitor | EWMH |
| Fixed | Used when client has a fixed size where width equals height, fixed clients are always floating | EWMH |
| IgnoreCfgReq | Ignore all configure requests coming from the client | EWMH |
| IgnoreCfgReqPos | Ignore the x,y position details of configure requests coming from the client | EWMH |
| IgnoreCfgReqSize | Ignore the size details of configure requests coming from the client | EWMH |
| IgnorePropTransientFor | Ignore WM_TRANSIENT_FOR property notifications for buggy client windows (e.g. WebStorm) | EWMH |
| IgnoreSizeHints | Ignore size hints for clients (floating and tiled) | EWMH |
| IgnoreMinimumSizeHints | While respecting size hints in general ignore the minimum size restrictions to avoid overlapping windows | EWMH |
| IgnoreDecorationHints | Ignore decoration hints for client | EWMH |
| RespectSizeHints | Respect size hints for this client when ResizeHints is globally disabled | EWMH |
| SkipTaskbar | Prevents the client window title from being shown in the bar | EWMH |
| AlwaysOnTop | Client window is intended to always display on top (even above floating windows) | Floating |
| Floating | The client is floating (i.e. not tiled) | Floating |
| FullScreen | Indicates that the client is in fullscreen mode | Fullscreen |
| FakeFullScreen | Indicates that the client is in fake fullscreen mode | Fullscreen |
| ScratchpadStayOnMon | Prevents the scratchpad from being moved to the active monitor when toggled | Scratchpads |
| SemiScratchpad | A window that switches between being a normal window and a scratchpad window | Scratchpads |
| NoSwallow | Indicates that the client should never swallow a terminal window | Swallow |
| SwallowRetainSize | Allow swallowed windows to retain their own size | Swallow |
| Terminal | Indicates that the client is a terminal, used by swallow | Swallow |
| RioDrawNoMatchPID | Do not match PID for this client when spawning via riospawn | Spawn |
| Debug | Enables debug logging on a per client basis | Window |
| Urgent | Indicates that the client urgently needs attention | Window |
| Centered | Indicates that the client, if floating, should be centered on the screen on launch | Window |
| Disallowed | Indicates that the window is disallowed in the window manager and will be forcibly killed on launch | Window |
| Permanent | If a client is permanent, then the client can not be killed | Window |
| Hidden | Indicates that the client is hidden | Window |
| Sticky | Makes the client sticky (placeholder, not implemented yet) | Window |
| OnlyModButtons | Restricts button keybindings to those that involve modifiers | Window |
| NoBorder | Indicates that the client should not be drawn with a border around it | Window |
| NoFocusOnNetActive | Disables the FocusOnNetActive functionality for the client | Window |
| NoWarp | Disables the Warp functionality for the client | Window |
| SteamGame | Indicates that this client is a Steam game | Window |
| Unmanaged | Indicates that the client is not to be managed by the window manager | Window |
| Lower | The window is to be placed below all other windows, only used in combinaton with Unmanaged
|
Window |
| Raise | The window is to be placed above all other windows, only used in combinaton with Unmanaged
|
Window |
| SwitchWorkspace | Automatically moves you to the workspace of the newly opened application | Workspaces |
| EnableWorkspace | Enables the workspace of the newly opened application in addition to your existing viewed workspaces | Workspaces |
| RevertWorkspace | If SwitchWorkspace or EnableWorkspace, closing that window reverts the view back to what it was previously | Workspaces |
Internal flags are flags that are set by the window manager when certain actions are performed.
These are generally not intended to be manually set via client rules or otherwise.
| Internal flags | Description | Topic |
|---|---|---|
| NeedResize | Internal flag indicating that the client needs to be resized later | EWMH |
| Transient | Whether the client has the transient for hint | EWMH |
| RefreshSizeHints | Internal flag used to indicate that the size hints for the window should be updated | EWMH |
| MoveResize | Used internally to indicate that the client is being moved or resized | Floating |
| MovePlace | Used internally to indicate that the client is being moved within stack | Floating |
| NeverFocus | Indicates that the client should never receive focus | Focus |
| Locked | Restrict movement of client windows in certain situations | Fullscreen |
| RestoreFakeFullScreen | Internal flag that indicates that fake fullscreen should be restored when exiting actual fullscreen | Fullscreen |
| Marked | Indicates that the client has been marked for group action | Marking |
| Invisible | By default all clients are visible, used by scratchpads to hide clients | Scratchpads |
| Ruled | Indicates whether client was subject to client rules (used internally to determine default behaviour) | System |
Back to Features.