Presets and links

A settings preset is a named set of stream settings you attach to a host, a game or one connect. A punktfunk:// link starts a stream you already set up, from a shortcut, a script or a browser. Both live in the Punktfunk apps, not in the host's web console.

What a preset isCopy Anchor Link

A preset stores only the rows you change; every other row follows your default settings, including later changes to them. Changing a row pins it, even to the value the default has. The row's Reset makes it follow the default again.

Presets stay on the device that made them; nothing syncs them. Linux keeps them in ~/.config/punktfunk/client-presets.json, Windows in %APPDATA%\punktfunk\client-presets.json, the Apple and Android apps in their own storage.

Creating and editing oneCopy Anchor Link

1. Open Settings and pick New preset from the switcher at the top.
2. Name it and pick a colour. The colour tints the preset's chip on host cards.
3. Change the rows you want. A changed row shows a marker and Reset.

Windows creates Preset 1 and opens it; rename it there. Names are unique, ignoring case. In the console (the controller interface) a changed row shows a dot, and X puts it back on the global value.

What a preset can't changeCopy Anchor Link

Rows that describe this device rather than the stream don't show in a preset: the list is on Client settings. Share clipboard is a per-host switch on the host's page or in its edit sheet, not a setting: see Shared clipboard.

Using a presetCopy Anchor Link

• Bind it to a host. Set Preset in the host's edit sheet, Connect with on the host page (Linux, Apple), or Default preset… in the console's host options. A plain click on the host uses it.
• Bind it to a game. In the console, open a game's options (X) → Settings preset…. Launching that game uses it instead of the host's preset.
• Use it once. The host card's menu → Connect with (on Android, Connect with: …). Default settings there streams without the host's preset.
• Pin it as a card. A pinned preset gets its own card beside the host. Pin it in the host's edit sheet (Android), on the host page (Linux, Apple), with Pin as card: … (Android) or Pin tiles (Windows) in the card menu, or from the console's Presets tab. Unpinning changes neither the preset nor the host.

The active preset's name shows in the stats overlay.

Deleting a preset says how many hosts and pinned cards use it. Those fall back to your default settings; nothing fails to connect.

punktfunk:// linksCopy Anchor Link

A link starts a stream on a host this device already trusts:

punktfunk://connect/<host-ref>[?fp=<64-hex>][&host=<addr[:port]>][&launch=<id>][&preset=<ref>][&as=<profile>][&name=<label>]

<host-ref> is a saved host's record id, its name (ignoring case), or addr[:port], tried in that order. A name that matches two hosts is refused.

Scheme and route are case-insensitive, unknown parameters are ignored, and a repeated parameter's first value wins. Limits: 2048 characters for the URL, 128 for <host-ref> and launch, 64 for preset, as and name. launch must be printable ASCII without spaces, quotes, \, $ or backticks.

browse takes the same form and opens the host's game library instead. The Apple apps and the Linux app handle it; Apple's library widget and Open Game Library shortcut use it. Other apps show a notice.

punktfunk://connect/Living%20Room%20PC
punktfunk://connect/Living%20Room%20PC?launch=steam:570
punktfunk://connect/Living%20Room%20PC?preset=Work

These name the host by label, so each asks first. Copy link writes the record id instead, which opens in one click.

What a link can and can't doCopy Anchor Link

A link can do what clicking a card you already have does, and no more.

• It carries references, never values: no resolution, bitrate or codec parameters.
• It can't pair. punktfunk://pair/… is refused; pairing stays manual.
• Only the record id connects without asking. A name or an address, including host=, shows Open this link? first, naming the host and the game.
• A host you haven't saved is never connected. With an address, Linux, Windows and the Android app open the normal trust prompt, filled in with the address and any fp; the Apple apps and Android's controller interface show a notice. Without an address the link is refused.
• An fp that doesn't match the host's pinned fingerprint is refused.
• A preset that matches nothing, or two presets, is refused before anything connects. With no preset, the host's own binding applies.
• A link never ends a running session; the app asks you to end it first. On Apple and Android, a link to the host you're already streaming brings the app forward.

Getting a link, and making a shortcutCopy Anchor Link

Copy link (Copy Link on Apple) is in the host card's menu on Linux, Windows, Mac, iPhone, iPad and Android, and in the console's host options (press Up on a host). On Linux, Windows, Android and the console a game in the library has one too, with its launch=. A pinned card's link carries its preset, except on Windows. A copied link carries the record id, host= and, once pinned, fp=, so it survives an address change or a reinstall.

Create shortcut… (Linux, Windows) and Add to home screen (Android) make a launcher:

• Linux: a desktop entry in ~/.local/share/applications/, from the host page or a game's details. Under Flatpak the app shows the URL for you to place yourself.
• Windows: a .lnk on your Desktop that runs punktfunk-client.exe with the URL.
• Android: a home-screen shortcut with the game's cover, from a game's long-press menu or its Details… card in the controller interface. Android TV launchers don't take shortcuts.

Starting a game from a frontendCopy Anchor Link

On Android, a game frontend that lists a folder of files can start a game through a .punktfunk launcher file.

1. On a game, choose Save launcher file… (long-press it in the library, or its Details… card in the controller interface). Save it into the folder the frontend scans.

2. Have the frontend open .punktfunk files with this activity and the file's URI:

   Copy Text

   am start -n io.unom.punktfunk/io.unom.punktfunk.MainActivity -a android.intent.action.VIEW -d <file URI>

A launcher file is the game's link on one line, as Copy link gives it, so a text editor can make one too. The rules above apply: a link to a host you haven't paired shows a notice.

From a script, use the punktfunk command:

punktfunk presets list
punktfunk open --yes 'punktfunk://connect/Desk?preset=Work'

--yes answers the confirmation a name or address raises.