LUCH
EN
Home / Where Luch runs / Steam Deck

Luch on Steam Deck

Download a shortcut, run it, type the password. In Game Mode the Luch panel appears in the quick menu ("···", the Decky tab): pick a TV, press, and you are showing.

The Last Campfire on the TV, the Deck in hand: the Deck's screen goes dark while the show runs. Click the video to open it full screen.

Installation

  1. Switch to Desktop Mode

    Press the Steam button, "Power", "Switch to Desktop". Everything else is done there, in the Deck's browser.

  2. Download the "Install Luch" shortcut

    Download "Install Luch"

    This is a small shortcut, like the one for Decky Loader: it downloads the installer itself (the Flatpak app toxblh.luch.Luch, about 4 MB), checks the checksum, installs it and starts the setup. It downloads from ALS, and if ALS is unavailable, from GitHub (the shortcut tries both in turn). Direct links: ALS, GitHub.

  3. Run the shortcut with a double click

    The file appears in "Downloads". If the system asks whether it may run it, allow it. The installer window opens: the system asks for the administrator password once (the Deck password), then a window with the Luch logo shows the stages: updating Decky Loader, installing the plugin, installing Luch, checking that it works. At the end Plasma flickers for a second: the Luch widget appears in the tray.

    The same from a terminal: flatpak run --command=luch-setup toxblh.luch.Luch

  4. Click "Finish" and go back to Game Mode

    In Game Mode press "···", the Decky tab, the "Luch" row. On the desktop the widget in the tray does the same: click the icon, pick a TV, press "Show screen".

    The installer leaves a "Luch" shortcut on the desktop. If you run it (or the downloaded shortcut) again, it asks what to do: "Reinstall" (the latest version is downloaded) or "Remove".

What is in the panel

The Steam Deck quick menu, the Decky tab: Luch is in the list of plugins
The quick menu "···", the Decky tab: the Luch plugin is in the list.
The Luch panel (Russian interface): receivers, mode and size for each
The Luch panel: receivers, mode and size for each. It is in English when Steam is in English.

Receivers

The list of devices on the network. Pressing a name starts or stops the show.

Mode and size

Fast mirror, 16:9 mirror, pick a screen, one window, a second screen. The size is from 1280×720 to 3840×2160. The choice is remembered for each receiver.

Sound

Play the sound on the Deck as well, or keep it on the receiving device only.

Screen dimming

During a show the Deck's screen goes down to the minimum 4 seconds after the menu is closed. Press Steam or "···", or stop the show: the brightness comes back.

The desktop widget

In Desktop Mode Luch lives in the tray: an icon next to the clock and the volume, a click opens a Plasma panel with the receivers. The installer adds it by itself.

The Luch panel above the Plasma tray: Google TV Streamer is ready, a
The widget in the tray: click the icon, pick a TV. (The interface follows the system language.)

What exactly gets installed

Nothing happens silently: you can look at this list before installing, and everything is removed with one command.

WhereWhat
Decky Loaderinstalled if it is missing, and updated when a new version is out (from ALS, or from GitHub if ALS is unavailable)
~/homebrew/plugins/Luchthe plugin for Decky Loader and the fast-mode helper. The folder belongs to Decky, so a password is needed (pkexec). The helper runs as root and answers only your user.
~/.config/systemd/user/luchd-flatpak.servicestarts Luch with your session, in Game Mode too
~/.local/share/plasma/plasmoids/toxblh.luch.panelthe Luch widget for the system tray (its icon and the tray setting; the installer hides the system's "background app" entry for the service)
~/Desktop/Luch.desktopthe "Luch" shortcut on the desktop: running it again offers to reinstall or remove
/etc/systemd/system/luch-deckyheal.*, /var/lib/luchself-heal: a timer that, after a SteamOS update, puts the plugin and Decky Loader back if they are gone
flatpak run --command=luch-setup toxblh.luch.Luch --list # what goes where flatpak run --command=luch-setup toxblh.luch.Luch --dry-run # show it, change nothing flatpak run --command=luch-setup toxblh.luch.Luch --remove # remove everything the setup installed

After a SteamOS update

The home folder and the user services survive updates. If the plugin or Decky Loader itself is gone after a big update, the luch-deckyheal self-heal service puts them back: at boot and then every 15 minutes it checks that the plugin is in place and Decky Loader answers, restarts it if needed, and if that does not help, reinstalls it (from ALS, or from GitHub if ALS is unavailable; at most once in 12 hours). You can follow what it does with journalctl -u luch-deckyheal.

If Decky Loader does not show plugins in the new Steam after a big update, run "Install Luch" once more: Decky Loader updates to the latest version.