Profiles
Give each person on the host a profile — their name on every session and, with seats, a desktop of their own — and how players pick one.
Give each person who plays on this host a profile: their name on every session and their own play stats, and with seats a desktop, a Steam and controllers of their own. A host starts with one profile, the owner, named after you; while it is the only one, nothing changes for anyone.
Add a profile
- In the web console, open Profiles → Add profile.
- Enter a Name, pick a Color, and optionally a picture.
- Under Where this profile plays, pick one:
- Shares Alex's desktop, with your name: the same desktop, Steam and games, under another name.
- Own account (take turns) (Windows): its own Windows account, Steam and saves, one person at a time — see On Windows. Any edition of Windows.
- Own desktop: a desktop of its own that plays at the same time as the others, with its own Steam and controllers, on Windows Server or Linux. It gets a new account, or someone's own account under Existing account: one of this PC's on Windows Server, a login of this machine on Linux.
On Linux, Own desktop needs Reachable without logging in and stays greyed until it is on. A host holds up to 8 profiles, and two can't share a name.
On Windows
Own account (take turns) binds a profile to a Windows account on this PC. When someone picks it, Punktfunk brings that account to the screen and streams it, so each person has their own desktop, Steam and saves. One person streams at a time — picking another profile switches the PC to that account, the way Windows' own Switch user does. This needs no Windows Server, no Remote Desktop and no extra licence. To play at the same time instead, see On Windows Server.
Set it up:
- In Windows, make an account for each person (Settings → Accounts → Other users) and sign in to each one once, so Windows has it ready. You don't have to stay signed in.
- In the console, Add profile → Own account (take turns), and pick that person's Windows account. Repeat for each person.
A player who picks a profile whose account isn't on the screen sees Switching to Kid… while the PC
changes over; the stream lands once it does. A card's Start, Stop and End session do the
same by hand. The owner profile is this desktop as it is: picking it streams whoever is signed in
now and switches nobody, which is what you want for playing at the PC itself.
Each person needs their own Steam account; Steam Families shares the games.
An account has to have been signed in since the PC last started before a profile can switch to it;
until then its card reads Sign Kid in at the host once.
On Windows Server
An Own desktop profile signs in to a Windows account of its own, so two people play at once without sharing a desktop. Seats on Windows has what it needs, the setup, an existing account as a seat, and Steam on a seat.
On Linux
Reachable without logging in makes the box answer clients from boot, with the lock screen still on your monitor. A paired device that picks your profile starts a session of yours in the background, and the monitor is never touched. It is also what gives a profile a desktop of its own: Own desktop is a user of its own with its own Steam, and up to four seats share the box, yours included.
-
Add your user to the group that may start the switch, then restart the computer. The host keeps the groups it started with, so logging out is not enough:
sudo usermod -aG punktfunk-update $USEROn SteamOS, run
bash ~/punktfunk/scripts/steamdeck/update.shin Konsole instead and enter your password: it sets the switch up and joins the group. Restart once after. On NixOS, setservices.punktfunk.seats.enable = true, rebuild and restart: the users inservices.punktfunk.host.usersjoin the group. -
Open Profiles and tick Reachable without logging in. Confirm with the console password. The page reloads while the host restarts, and the console asks you to sign in again.
What turning it on does:
- Files move. The host's identity, pairings, profiles and the console password are copied
to
/var/lib/punktfunk, owned by apunktfunksystem user that runs the host from then on. Display settings and hooks stay yours. Paired clients keep working. - You become a seat. Your own desktop is the first seat, with your library, plugins and Steam.
- The monitor wins. When you log in at the machine, the background session ends within a few seconds and your own session hosts you. Streams on the background session end, and the client reconnects. Nothing on your monitor is closed.
- The console stays put. It listens on the same port with the same password.
- Seats see your games. Every seat shows your Steam libraries: its Steam plays, updates and
runs Proton from them while the files stay yours. A library on a filesystem other than btrfs,
ext4, xfs or f2fs stays hidden from seats. New games a seat installs go to
/var/lib/punktfunk-seats/games. - Your library is the box's. Every profile's apps list the games your own host found. A profile with a desktop of its own plays your Steam games with its own Steam, and ROM Manager games with the box's emulators and its own saves. RPCS3, shadPS4, Supermodel, Vita3K and Xenia Canary play on your desktop only. So does an emulator installed while seats were off or by an earlier version, until you reinstall it under Library → Sources → Emulators. Your own custom emulators and games from other launchers play on your desktop only. Change the library on your own Library page; another seat's is read only.
- A seat has Game Mode too. Return to Gaming Mode on a seat's desktop opens Steam's Game Mode on that seat, and Steam's Switch to Desktop goes back. The stream carries on, and neither touches the box's own session. The desktop's apps keep running underneath, and Steam keeps running when you disconnect in Game Mode. A seat starts in the mode it was last in.
Turning it off copies the files back to your home and your own host serves the box again. Seats of their own stay on the box, stopped, and come back with the switch.
| Check | Fix |
|---|---|
The switch says Add … to the punktfunk-update group first | Run the command in step 1, restart, then try again. |
| The switch is greyed out, with a line under it | The line names what this box is missing and the command that adds it. Reload the page after. |
| A profile shows Unavailable | Its seat didn't start. Doctor names the failing check. |
A seat on someone's own account
Existing account under Own desktop plays on a person's own login of this machine, and only their password or a device they signed in opens it. Someone's own account covers adding one, what the person sees when they connect, and signing devices out.
Give a controller plugged into the PC to a profile
A controller plugged into this PC's own USB port belongs to the PC's desktop, and no seat can use it. Give it to one profile that has a seat, and that seat's Steam and games open the real controller: rumble, haptics, gyro, trackpads and its own sound card work as the hardware does them.
- Plug the controller into the PC and open Profiles.
- On the card Controllers on this PC, open Used by on the controller's row.
- Pick the profile. This PC gives it back.
- One holder. Only that profile's seat sees the controller. The PC's desktop and every other seat don't, not even for an instant after it is plugged in.
- Your change only. The controller changes hands only when you change it here, and it reconnects once each time.
- A stopped seat parks it. While the profile's seat isn't running, nobody can use the controller. It doesn't fall back to the PC; give it back, or start the seat.
- It stays. A replug, a restart and an update keep it with the profile. A controller with a serial number is recognised in any USB port. One without is recognised by its port, so keep it in that port. Two controllers that report the same serial number are told apart by their ports while both are plugged in.
- Your own profile. A controller given to the owner's profile also opens at the PC's desktop while you're signed in there: both are the same user.
What can be given:
- USB game controllers only, wheels and flight sticks included, up to four per profile. Never a keyboard, a mouse, storage or any other device.
- A wireless receiver such as a Steam Controller Puck goes as a whole, with every controller connected to it.
- Bluetooth controllers paired to the PC aren't covered.
- A controller's built-in keyboard and mouse emulation, a Steam Controller's desktop mode, is off for everyone while a profile has it.
The client that shows the seat's picture never sees the controller. It can't open Punktfunk's menu or shortcuts in the stream, it isn't in the session's controller list or in Diagnostics → Controllers, and using it doesn't count as someone playing: a seat nobody streams still stops after Stop an idle seat after.
On Windows a few things differ: see Seats on Windows. If a controller stops working, Input & controllers has the fixes.
What a seat can do
A player who picks a stopped seat sees Getting Kid's desktop ready… while it starts. A card's
Start, Stop and End session do the same by hand; End session keeps the seat
running.
A seat's desktop is one virtual screen at its player's resolution. It never shows, turns off or powers down a monitor of this machine, so a seat offers no screen roles: a host card's Screen section shows no rows there, whatever the device's access. A second device on the same seat shares the screen when its A second device connects is Shares the screen, and is told the seat is busy otherwise. Only the owner's desktop follows Displays; of a device's display settings, only Largest screen this device gets, the scale and A second device connects follow it onto a seat. With Browser streaming on, a browser plays on its profile's seat too, on the seat's own port.
Every seat shares one set of Seats settings on Host, shown while seats are on:
- Seats kept warm: the seats of the most recent players start with the host.
- Stop an idle seat after: 240 minutes by default; 0 never stops one. Your own seat never stops for this. A seat on someone's own account neither stops for this nor starts warm.
- End a seat's stream when its game exits: off keeps streaming the seat's desktop. A profile can pick its own.
- Highest mode per seat, such as
2560x1440@120: a device's own cap outranks it. - Seats update your games (Linux): off, seats play the games you installed but can't update them or install into your libraries. A seat picks up a change when it next starts.
Each profile's own library
Every profile plays the same games, and each can see them its own way. Once the host has a second profile, the title of Library is a pick (Anna's library ▾) that lists every profile. The pick stays as you move between pages. In a profile's library you can:
- Hide for Anna: the game leaves Anna's shelf and can't be started as Anna. Show for Anna again brings it back.
- Set a game's Stream settings for Anna alone. They show Only for Anna, and Use Enrico's setting drops them.
- Pick Anna's own cover or artwork for a game; Use Enrico's picture drops it.
- Under Sources, turn a source off to hide all its games from Anna.
A profile only ever narrows your library. A game you hide, or a source you turn off, in your own library stays hidden for everyone, and shows there as Turned off in Enrico's library. Shared games are added, edited, installed and removed in your library, which the link under the title opens. None of this needs the profile's desktop to be running.
A profile with a desktop of its own on a New account can also have games nobody else has. Add game for Kid adds a game or a command that is kept on Kid's desktop and runs there as Kid. It shows Only for Kid and is on Kid's shelf whether the desktop is running or not. Adding, changing or deleting one starts Kid's desktop first, which takes about 20 seconds, and a cover picked from a file on that desktop shows only while it runs. A profile on someone's own account has none: a game added from the console would run as that person.
The Apple, Android, Linux and Windows apps show a player the library of the profile they play as. Hiding a game is for tidiness, not a lock: a player who picks another profile sees that profile's games, and a person on their own account can change their own copy.
Plugins and Automation follow the same pick for a profile with a desktop of its own.
How players pick
On a host with two or more profiles, the Apple, Android, Linux and Windows apps ask Who's playing on Living Room PC? on the first connect and remember the answer for that host. The host card then shows the pick's initials, and Switch profile… in the host's menu changes it.
The controller interface asks on every connect instead:
- Turn on Remember on this device under the profiles to stop the question on that host. The card then shows the pick's initials.
- The button under a host card, Playing as Kid or Who's playing?, changes the pick or sets Always ask.
- On Games, the pill with the host's name opens Host and profile: pick the host whose games show and who plays there.
Elsewhere:
- A
punktfunk://link'sas=or the command line's--asplays as a profile for one connect. - The Decky plugin shows one chip per profile under the host.
- Moonlight and the other clients play as the owner.
Anyone on a paired device may pick any profile, except one you lock and one on someone's own account, which asks for its password. What a device may do stays its access level.
Lock a profile
A locked profile opens only on the devices you choose. On the profile's card, Lock it, then Add a device from the devices paired with this host, Punktfunk or Moonlight. Unlocking, giving it a PIN and adding a device ask for the console password.
- A device on its list opens it as before. Any other device doesn't see it when it picks a
profile, and a connect that names it is told
This device can't open this profile. Ask the host's owner to add it. - A PIN of 4 to 8 digits lets a device off the list in. A locked profile with a PIN shows in
every device's picker, and the right PIN puts that device on its list for the visit, or until
you sign it out when the device stays signed in. A device with a fingerprint reader or face
unlock can keep that instead, and opens the profile with it from then on. An app that can't
ask for a PIN yet says
This profile needs its PIN. Update Punktfunk on this device. - Wrong PINs make a device wait, as a wrong account password does. Ten wrong PINs for one profile within 15 minutes, from any devices, stop PIN entry for it for a while. Each further round of ten doubles the wait, up to a day, until the right PIN or a new one; the devices on its list still open it.
- Signing a device out ends its session, and so does locking a profile it plays unless you keep that device when you lock.
- The devices on its list can hide a game from this profile's shelf with Hide for Kid in the game's menu, and bring it back from Hidden for Kid. The Linux and Windows apps and the controller interface offer it. Changing this profile's own games and game-exit choice waits for the Punktfunk apps to offer it.
- Locking the owner profile also keeps Moonlight to the Moonlight devices on its list.
- A profile that shares your desktop opens with your lock, your devices and your PIN: one desktop, one lock. A profile on its own Windows account (take turns) has a lock of its own.
- Unlock keeps the PIN for the next lock. Locking again starts from the devices you choose then.
The locks live in profile-locks.json beside the host's pairings, readable by the host alone. A
file the host can't read keeps every profile locked, and the console says so: fix or remove it.
Removing it unlocks every profile.
Where a profile shows
- Now on Home puts the player's picture and name before the device, once the host has two profiles.
- Devices → Approve names the profile a waiting device asks to play as.
- The game library counts each profile's play time beside the totals.
- Hooks and events carry the profile of the session.
Change or remove a profile
On the profile's card: Rename, Choose picture or Remove picture (PNG or JPEG under 1 MB), and Remove. For a profile with a desktop of its own, Rename also offers When the game exits: As the host does follows End a seat's stream when its game exits, and End the session or Keep streaming set it for that profile alone. On someone's own account a game's exit always goes back to their desktop. Removing asks for the console password and ends every session playing as that profile with "Your profile was removed by the host's owner." For a profile named Kid whose own Steam the host still keeps, Also delete Kid's Steam and saved games on this host erases that Steam too; without it, the files stay on the host. The owner can't be removed.
Access levels
Choose what each paired device may do and for how long — presets, single grants, temporary access, couch co-op, and what access doesn't cover.
Someone's own account
Give a person a profile on their own Linux login, opened only with their password or their own device, and sign its devices out.