Windows and workspaces

bromigOS arranges windows for you. Each new window gets a share of the screen, and no window hides another unless you let it float. You move between windows and workspaces with the keyboard, or with the mouse if you prefer.

The window keys use Alt. If you’d rather use Super, see Use Super for the window keys.

How windows are arranged

The first window takes the large space on the left. Each new window goes to the top of the stack on the right. Close a window and the rest grow to fill the space.

To	Press
move to the next or previous window	`Alt`+`J` or `Alt`+`K`
move to the window on the left or right	`Alt`+`H` or `Alt`+`L`
make this window the large one	`Alt`+`Enter`
move this window left, right, up or down	`Alt`+`Shift` and `H`, `L`, `K` or `J`
move the edge between the large window and the stack	`Alt`+`←` or `Alt`+`→`
close this window	`Alt`+`C`

Pointing at a window with the mouse also moves you to it. To change that, open Settings › Keyboard & input and choose another Window focus.

Use the mouse

To move a window, hold Alt and drag it with the left mouse button.
To resize a window, hold Alt and drag it with the right mouse button.

Make a window bigger

To	Press
fill the screen, but keep the bar	`Alt`+`F`
go fullscreen, over the bar	`Alt`+`Shift`+`F`

Press the same keys again to put the window back.

Let a window float

A floating window sits above the others, at any size, like on most desktops. Dialog boxes float on their own.

To float the window you’re in, press Alt+Shift+V. Press it again to put the window back in the tiles.

Put floating windows back where you left them

bromigOS can remember where you put a floating window, for each workspace, and put it there the next time it opens.

Open Settings › Startup.
Under Windows put back, turn on Every floating window. Or type one app’s class in Remember an app (its class), such as org.pulseaudio.pavucontrol for the volume mixer.
Choose Restart on the bromigos-windows row, or log in again. The change works from then on.

To find an app’s class, run hyprctl clients in a terminal while the app is open.

Or from a terminal:

bromigos startup windows remember org.pulseaudio.pavucontrol   # remember this app's windows
bromigos startup windows restart                               # use the change now
bromigos windows list                                          # what's remembered
bromigos windows clear                                         # forget them all

Workspaces

A workspace is a separate screenful of windows. There are ten. Use them to keep tasks apart: a browser on one, your project on another.

To	Press
go to workspace 1 to 10	`Alt` and a number key. `0` is workspace 10.
send this window to another workspace	`Alt`+`Shift` and a number key

Sending a window doesn’t move you with it. The bar shows the workspaces that have windows. Click one to go there.

On a laptop, swipe sideways with three fingers on the touchpad to move between workspaces.

With more than one monitor

The ten workspaces are shared out across your monitors, from left to right. With two monitors, workspaces 1 to 5 are on the left one and 6 to 10 on the right one. Pressing a workspace’s key takes you to the monitor it’s on.

To choose which workspaces go on which monitor, see the workspaces setting in your ~/.config/hypr/hyprland.lua. The file’s comments show the format.

The scratchpad

The scratchpad is a hidden workspace that opens over the one you’re on. It’s handy for a terminal or notes you want now and then.

To	Press
put this window on the scratchpad	`Alt`+`Shift`+`S`
show or hide the scratchpad	`Alt`+`S`

Switch windows from a list

Press Alt+Tab for a list of every open window. Type to filter it, and press Enter to go to the one you pick.

Keyboard shortcuts

The bromigOS Manual