Skip to content

v0.7.0

Latest

Choose a tag to compare

@github-actions github-actions released this 18 Nov 22:58
23c31ae

Read this first if you are upgrading from 0.6.x

The root helper is gone. Each player now runs as you, in a rootless bwrap sandbox with a private home and session bus. No system service, no Polkit rules, no extra Linux accounts, no root at run time.

What you need to do once:

  1. Update (in-app Update now, or the installer).

  2. If the Home page shows "An older CouchPlay helper is still installed", run the migration. It imports your old players and removes the old helper. It needs sudo and is not run for you:

    curl -fsSL https://raw.githubusercontent.com/hikaps/couchplay/main/scripts/migrate-from-helper.sh -o migrate-from-helper.sh
    sudo bash migrate-from-helper.sh --user "$USER" --flatpak          # dry run: lists players and sizes
    sudo bash migrate-from-helper.sh --user "$USER" --flatpak --yes    # do it

    Players on a big drive: add --players-dir /path/on/that/drive. Native (tarball) install: leave out --flatpak.

  3. Re-pair your Moonlight clients (pairing state is per player and is recreated).

Your old players, logins and saves are not imported until you run the migration. Saved profiles keep working: the old username key is still read and rewritten as player on save.

Host requirements: bubblewrap, dbus (dbus-run-session), gamescope and a user-writable /dev/uinput. The Home page warns if any is missing. On Ubuntu 23.10+ the installer offers one narrow AppArmor rule so bwrap can create user namespaces.

Changes

  • Rootless sandboxes replace the root helper (#164): one virtual Xbox 360 pad per player; the host network stays shared, so LAN and online co-op work.
  • The installer runs as your user (#167, #168): the Flatpak install needs no sudo; only --tarball and the AppArmor step ask for it. curl … | bash works when piped.
  • Migration and missing-tool notices on the Home page and in the installer (#166, #169). An empty leftover couchplay group no longer triggers a false "helper still installed" warning.
  • Steam: players share the host's shader cache (#165) and use the host's default Proton choice (#161); the private Steam IPC address is set through the environment only (#162).
  • Settings: removed the "Close Steam before starting" option, which did nothing (#159).

Known limits

  • Steam Family Sharing: a game can't be played by two accounts at the same time.
  • If a game crashes for one player right after you changed its files, delete that player's saved layer for the game and start again.
  • Real controllers, audio, KWin placement and Sunshine/Moonlight streaming are checked by hand, not by automated tests.