---
title: Twitch Desktop Tools
description: Use the Omarchy Twitch panel and notification recovery commands.
sidebar:
  order: 10
---

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:

```bash
uwsm-app -s b -- twitch-notifications
```

The shared resume hook also restarts Twitch notifications after suspend. See [Resume Recovery](/knowledge-base/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:

```bash
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:

```bash
twitch-notifications --status-json
```

Configured channels still come from:

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

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

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

## Recheck notifications

```bash
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

```bash
twitch-notifications-restart
```

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

```bash
uwsm-app -s b -- twitch-notifications
```

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

```bash
twitch-notifications --restart --open
```

## Troubleshooting

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

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

If live state looks stale, run:

```bash
twitch-notifications-recheck
```

If the process is wedged, run:

```bash
twitch-notifications-restart
```

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

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