Skip to content
GitHub

The control centre

The control centre is a grid of blocks under one row of buttons. It opens with SUPER A, with a click on the island at rest or on its glance, or with the Control centre button if it is on the bar. The same key closes it, and so do Escape and a click anywhere off the island.

A control centre, with a row of shortcuts along the bottom.

Small buttons over the grid, on a left and a right side. Out of the box, the session’s actions are on the left — Lock, Suspend, Log out, Restart, Shut down — and doors to other panels on the right: System statistics, Settings, Pet, Games, Notes and Task board. Lock and Suspend run at once; the other three turn red on the first click and run on the second.

Any button can go on either side. The doors on offer are System statistics, Settings, Pet, Games, Notes, Task board, Workspace overview, Launcher, Appearance, Session menu, Keys, Packages, Servers, Screen time and Camera. With both sides empty there is no row, and no space for one.

  • In Settings → Control Centre → The top row, the row is drawn in miniature with a tray of the buttons on neither side. Drag a button from the tray onto a side, along it, across to the other, or back into the tray to take it off.
  • While arranging, click the row as you would a block. Its card lists every button with a tick for the ones on the row, the side each is on (a click moves it across), and arrows to order it along that side. An empty row shows while arranging, so it can be filled.

A grid of blocks, and every block takes a whole number of cells. It is six columns by eight rows out of the box, and two to six columns by two to eight rows can be chosen. A cell is one toggle tile, wider than it is tall, so the square sizes are 1×2 and 2×4. Blocks never overlap, and a block can be on the grid more than once.

Out of the box: the toggles, the volume and brightness sliders and the appearance card down the left; the player, the weather and the month in the middle; the notifications down the right.

BlockSizes (columns × rows)What it holds
Toggles2×2, 2×3, 2×4, 3×2, 3×3, 4×2, 4×3Switches and one-press actions, in pages (below)
Volume2×1, 3×1, 4×1The output’s slider; its chevron opens the sound page
Brightness2×1, 3×1, 4×1The slider for the screen the keyboard is on; with several screens, a chevron opens one for each
Appearance2×2, 2×3, 2×4, 3×3, 4×2The wallpaper; a click opens the appearance panel
Media2×2, 2×3, 3×2, 4×2The player
Weather2×1, 2×2, 2×3, 4×2The conditions now, and the rest of the day when there is room
Calendar2×3, 2×4, 3×4The month, a dot under each day with tasks; such a day turns into its list
Notifications3×2, 3×3, 2×4, 3×4, 2×6, 2×8, 3×8The history, with Clear
Session1×1, 2×1, 3×1, 1×2, 2×2, 4×1Round buttons for Lock, Suspend, Log out, Restart and Shut down
Shortcuts1×1, 2×1, 3×1, 1×2, 2×2, 4×1, 6×1Round buttons that open other panels, chosen per block
impasto1×2, 2×2, 2×4The terminal greeting in miniature: the palette board and the machine’s lines
Pet2×2, 2×3The pet’s face and mood, feed and play; three rows add the shelf
Clock1×2, 2×2, 2×4The time over the day, larger with the room
Games2×1, 2×2The last best and Play; two rows, the last three games
Notes1×2, 2×2, 2×4The front note of the deck; a click opens it
Tasks1×2, 2×2, 2×3, 2×4How many are left and what is next; larger, the next few with Open

A block with nothing to show (the player with no music) draws its empty card rather than leaving the cell. Session and shortcuts blocks hold as many buttons as their cells fit.

One block, in pages. A page is what fits the block; the rest go on further pages, turned with the wheel, a sideways drag, the arrows or the dots along the bottom. The six out of the box are Wi-Fi, Bluetooth, Power, Focus, Microphone and Airplane.

TileWhat it does
Wi-FiSwitches the radio. Its chevron opens the Wi-Fi list.
BluetoothSwitches Bluetooth. Its chevron opens the device list.
PowerSwitches the power profile between balanced and performance; lit on performance
FocusDo not disturb — notifications stay off the island
MicrophoneMutes the microphone. Its chevron opens its page.
AirplaneWi-Fi and Bluetooth off together, or back on
Night lightA warmer screen, through hyprsunset. Its chevron opens its page.
OutputMutes the sound
DockShows or hides the dock
NotchCuts the island into the top edge, or floats it
ShadowsThe shadows on the windows, the bar, the dock and the widgets, all at once
Game modeStills the shell, makes it solid, and drops Hyprland’s animations, blur, shadows and refraction; see game mode
CaptureOpens the capture surface on its last choices
AnnotateA region, straight into satty
Read textA region, read as text onto the clipboard
ColourThe colour of one pixel, onto the clipboard
RecordRecords the screen the keyboard is on, at once, or stops the recording
Clear clipboardEmpties the clipboard history; only there while something is kept

The last six close the panel first, so it is not in the picture. A tile the machine cannot do (no Bluetooth adapter, no satty, no hyprpicker) is dimmed and does nothing.

The Wi-Fi list shows the networks in range with their signal, which are secured and which are saved, a Rescan and the switch. A click on a secured network opens a password field in its row. The Bluetooth list shows the devices that have a name, and anything paired or connected; the unnamed ones are folded under a line at the bottom. A click connects. Both lists also open from the Network and Bluetooth pieces on the bar.

A chevron opens a page of its own in the island, as the Wi-Fi and Bluetooth tiles open their lists. The back arrow at the top returns to the control centre.

  • Sound, from the volume slider: the output’s level, a row for every application playing with its own level, and the outputs to choose from.
  • Microphone, from its tile: the input’s level, every application recording it with its own level, and the inputs to choose from.
  • Night light, from its tile: the warmth as a level, and four presets, Candle, Warm, Soft and Neutral, 2500 K to 5500 K. The tile itself is the switch.
  • Brightness, from its slider when there is more than one screen to dim: a level for each screen, by name. With one screen there is no chevron.
The sound page: the level, each application's, and the output.
  1. Right-click the panel’s margin or the space between blocks, or open Settings → Control Centre and press Edit. The grid’s cells show. Left of the island, one card sets the grid’s size and another edits the top row; on the right, a card holds every block at the smallest size it offers, grouped under Controls, At a glance and Personal. A screen with no room beside the island stacks them under it instead.

  2. Drag a block from the card onto a cell, or drag a block on the grid to move it. The cell it will land on lights before you let go. A click on a block on the card puts it in the first free place.

  3. Pull a block’s corner, or scroll over it, to step through the sizes it offers.

  4. Take a block off with its ⊖ badge, or by dropping it on the card.

  5. Click a block for its card: its name, Remove, and its sizes. On a toggles block the card lists every tile with a tick, and arrows to order the ones ticked; on a shortcuts block it does the same for the doors. So two blocks of either kind can carry two different sets. Click the top row for its card.

  6. Press Escape, right-click the margin again, or close the panel. A second Escape closes the island.

Arranging, with the card of every block under it.

The size is picked on a miniature of the largest grid, lit from the top left: the cell clicked becomes the grid’s far corner. Columns come and go on both sides alike, so the blocks stay centred. The same miniature is under Settings → Control Centre → The panel → Size, and Default layout, beside Edit there, puts the grid back as it came.