Command Subsystem

August 8, 2026 ยท View on GitHub

This subsystem allows clients to execute new commands on the server.

ComponentLink
clientxpra.client.subsystem.command
client connectionn/a
serverxpra.server.subsystem.command
CapabilityTypePurpose
xdg-menubooleanThe client wants to receive the menu of commands available on the server

Server-to-Client

If the client requested it, the server sends the menu using a generic setting-change packet:

ArgumentTypePurpose
setting-changestringpacket type
xdg-menustringsetting
menu-datadictionaryThe updated menu

Client-to-Server

The only packet type that can be sent to the server is command-start:

ArgumentTypePurpose
command-startstringpacket type
namestringThe name of the command to execute, for presentation purposes only
commandlist of stringsThe full command to execute
ignorebooleanWhether this command should be taken into account by the exit-with-children server feature
sharingbooleanWhether this application should be shared with other clients connected to the same server or not