Automatic page switching

How it works

Each page can be linked to windows using two patterns: the window class (which app it is) and the window title. When a focused window matches, StreamController loads that page on the decks you chose. Both patterns are regular expressions and default to .*, which matches anything.

Setting it up

1. Open the Page Manager and select the page.
2. In the automatic change section, turn it on.
3. Enter a pattern for the window class, for example spotify or firefox, and a title pattern if you need to be more specific.
4. Check the list of matching windows the editor shows; it updates as you type, so you can see the pattern is right.
5. Pick which decks should switch, and whether the deck should stay on the page after you move to a window that doesn't match.

GNOME

GNOME on Wayland doesn't let apps see which window is focused. StreamController ships a small GNOME Shell extension that reports it, and offers to install it the first time you need it.

KDE Plasma

Install kdotool from your distribution or from source. StreamController uses it to ask KWin for the active window.

Hyprland and Sway

Supported directly through each compositor's IPC. Nothing to install.

X11

Any X11 session works, whatever the desktop or window manager.

Keys that should never change

Mark keys as sticky to keep them on every page, so a mic mute or home key stays put while everything around it switches.