Twitch Desktop Tools

The timmo.twitch Omarchy Shell plugin shows notification state in the bar and opens an attached channel panel. twitch-notifications remains the state owner and notification daemon.

Autostart

The shared Hyprland autostart starts Twitch notifications for both desktop and laptop in UWSM’s background graphical slice:

uwsm-app -s b -- twitch-notifications

The shared resume hook also restarts Twitch notifications after suspend. See Resume Recovery.

Bindings

Binding	Action
CTRL+ALT+T	Toggle the Twitch panel.
SUPER+ALT+T	Open the Twitch following live page as a webapp.

Twitch panel

Open the panel from a terminal:

omarchy-shell shell summon timmo.twitch '{}'

The panel shows live channels first, followed by configured offline channels. Select a live channel to open its stream or an offline channel to open its recent broadcasts. Opening a Twitch link closes the panel.

Panel actions include:

• Recheck notifications.
• Open all live autolaunch channels.
• Open following.
• Open following live.
• Restart notifications.

Mouse controls on the bar item:

• Left click opens or closes the panel.
• Middle click rechecks notifications.
• Right click restarts the daemon.

Use Up/Down or j/k to move, Enter to activate, r to recheck, Escape to close, and Tab to move to the next bar panel.

On the desktop host, channel links use xdg-open. Other hosts use omarchy-launch-webapp.

Channel state

The panel reads structured status from:

twitch-notifications --status-json

Configured channels still come from:

${XDG_CONFIG_HOME:-~/.config}/twitch-notifications/channels.yml

The existing status-bar format remains available for the dot dashboard source:

twitch-notifications --status-bar-json --max-chars 60

Recheck notifications

twitch-notifications-recheck

The helper detaches from the caller. If twitch-notifications --status reports active, it runs twitch-notifications --recheck. Otherwise it falls back to the restart helper.

Restart notifications

twitch-notifications-restart

The helper detaches, stops matching twitch-notifications processes, waits one second, then relaunches through:

uwsm-app -s b -- twitch-notifications

To gracefully restart the running daemon and open configured live channels during its initial check, run:

twitch-notifications --restart --open

Troubleshooting

If the panel has no channels, check that the channels file exists and contains - name: ... entries:

ls ~/.config/twitch-notifications/channels.yml

If live state looks stale, run:

twitch-notifications-recheck

If the process is wedged, run:

twitch-notifications-restart

If the panel does not open, confirm that the plugin is discovered and summon it directly:

omarchy-shell shell listPlugins
omarchy-shell shell summon timmo.twitch '{}'