nativeapps

Oct 16, 2026

Changes in this version

+ type LoginServiceAdmissionProof = hostdesktop.LoginServiceAdmissionProof

Oct 16, 2026

Changes in this version

+ const LoginServiceManagementVersion

+ func VerifyLoginServiceAdmission(ctx context.Context, path string) (string, error)

+ type LoginServiceDeploymentCommand = hostdesktop.LoginServiceDeploymentCommand

+ type LoginServiceDeploymentControl = hostdesktop.LoginServiceDeploymentControl

type ServiceStatus

+ func ManageLoginScreenServiceControlled(ctx context.Context, request LoginServiceDeploymentRequest, ...) (ServiceStatus, error)

Oct 15, 2026

Changes in this version

+ const HostDesktopDefaultFrameWindow

+ const HostDesktopMaxFrameWindow

Oct 9, 2026

Changes in this version

+ var ErrServiceUpdateRequired = hostdesktop.ErrServiceUpdateRequired

+ func PrepareLoginScreenMedia(ctx context.Context, cache, output string, progress func(Status)) (string, error)

+ type HostDesktopCursorPosition = hostdesktop.HostDesktopCursorPosition

Oct 8, 2026

Changes in this version

+ const LoginServiceSocket

+ const ServiceStopped

+ func RunLoginScreenService(ctx context.Context, config LoginServiceConfig) error

+ type HostDesktopServiceKit struct

+ Files map[string][]byte

+ ServiceSHA256 string

+ WorkerSHA256 string

+ func LoginScreenServiceKit(architecture string) (HostDesktopServiceKit, error)

+ func (kit HostDesktopServiceKit) Write(ctx context.Context, directory string) error

+ type LoginScreenConnection = hostdesktop.LoginScreenConnection

+ func OpenLoginScreenSession(ctx context.Context, path string) (*LoginScreenConnection, error)

+ type LoginServiceConfig = hostdesktop.LoginServiceConfig

+ type LoginServiceDeploymentEvent = hostdesktop.LoginServiceDeploymentEvent

+ type LoginServiceDeploymentRequest = hostdesktop.LoginServiceDeploymentRequest

type ServiceStatus

+ func InstalledLoginServiceStatus(ctx context.Context, path string) (ServiceStatus, error)

+ func ManageLoginScreenService(ctx context.Context, request LoginServiceDeploymentRequest, ...) (ServiceStatus, error)

Oct 7, 2026

Changes in this version

+ const LoginScreenService

+ const ServiceActive

+ const ServiceAuthorization

+ const ServiceFailed

+ const ServiceInstalling

+ const ServiceNotInstalled

+ const ServiceUninstalling

+ const ServiceUnsupported

+ var ErrServiceAuthorization = errors.New("administrator authorization is required")

+ var ErrServiceNotInstalled = errors.New("login-screen service is not installed")

+ var ErrServiceUnsupported = errors.New("login-screen service is unsupported")

type HostDesktopCapabilities

+ LockedScreen bool

+ Service string

type HostDesktopCommand

+ Service string

type HostDesktopMessage

+ Service string

+ ServiceStatus *HostDesktopServiceStatus

+ type HostDesktopServiceStatus struct

+ Backend string

+ Reason string

+ State string

+ type LoginServiceManager struct

+ func NewLoginServiceManager() *LoginServiceManager

+ func (m *LoginServiceManager) Install(ctx context.Context) (ServiceStatus, error)

+ func (m *LoginServiceManager) OpenLoginSession(context.Context) (string, ServiceStatus, error)

+ func (m *LoginServiceManager) Status(context.Context) (ServiceStatus, error)

+ func (m *LoginServiceManager) Uninstall(ctx context.Context) (ServiceStatus, error)

+ type ServiceStatus = HostDesktopServiceStatus

Oct 7, 2026

Changes in this version

type Artifact

+ Mirrors []string

Oct 4, 2026

Changes in this version

type HostDesktopMessage

+ Cursor string

Oct 4, 2026

Changes in this version

type HostDesktopMessage

+ HotX int

+ HotY int

Oct 3, 2026

Changes in this version

type HostDesktopCapabilities

+ Authorization string

type HostDesktopMessage

+ Authorization string

Oct 2, 2026

Changes in this version

type PreparedViewer

+ func (v *PreparedViewer) DocumentWithOptions(basePath string, options ViewerDocumentOptions) ([]byte, error)

+ type ViewerDocumentOptions struct

+ TransportScriptURL string

Oct 1, 2026

Changes in this version

+ const HostDesktopProtocolVersion

+ var ErrHostDesktopProtocol = errors.New("invalid host desktop protocol")

+ func HostDesktopClientResource(name string) ([]byte, error)

+ func HostDesktopSelfTest(parent context.Context, root, architecture string) error

+ func WriteHostDesktopCommand(writer io.Writer, command HostDesktopCommand) error

+ func WriteHostDesktopMessage(writer io.Writer, message HostDesktopMessage) error

+ type HostDesktopCapabilities struct

+ Audio bool

+ Backend string

+ Clipboard bool

+ Displays []HostDesktopDisplay

+ Encoder string

+ Input bool

+ Reason string

+ Screen bool

+ State string

+ Unattended bool

+ Unlock bool

+ type HostDesktopCommand struct

+ DisplayID string

+ Enabled *bool

+ FrameID uint64

+ Generation uint64

+ ID uint64

+ Input *HostDesktopInput

+ Method string

+ Mode string

+ Picture *HostDesktopPicture

+ Text *string

+ Unattended bool

+ Version int

+ func ParseHostDesktopCommand(data []byte) (HostDesktopCommand, error)

+ func (command HostDesktopCommand) Valid() bool

+ type HostDesktopDisplay struct

+ Height int

+ ID string

+ Name string

+ Primary bool

+ Scale float64

+ Width int

+ X int

+ Y int

+ type HostDesktopInput struct

+ Alt bool

+ Button int

+ Clicks int

+ Code string

+ Control bool

+ DX float64

+ DY float64

+ Key string

+ Kind string

+ Location int

+ Meta bool

+ Pressed bool

+ Repeat bool

+ Shift bool

+ Text string

+ X float64

+ Y float64

+ type HostDesktopMessage struct

+ Bytes int

+ Capabilities *HostDesktopCapabilities

+ Channels int

+ Code string

+ Codec string

+ Data []byte

+ Description string

+ DisplayID string

+ Displays []HostDesktopDisplay

+ Encoder string

+ FrameID uint64

+ Generation uint64

+ Height int

+ ID uint64

+ Key bool

+ Mode string

+ Profile string

+ SampleRate int

+ State string

+ Text *string

+ Timestamp int64

+ Type string

+ Version int

+ Width int

+ func ReadHostDesktopMessage(reader io.Reader) (HostDesktopMessage, error)

+ type HostDesktopPicture struct

+ Audio bool

+ FrameRate int

+ MaxDimension int

+ Mode string

+ NativePixels bool

+ type HostDesktopTools struct

+ Helper string

+ Python string

+ Root string

+ func ResolveHostDesktopTools(root, architecture string) (HostDesktopTools, error)

type Manager

+ func (m *Manager) HostDesktopTools() (HostDesktopTools, error)

type Package

+ func HostDesktopForPlatform(platform, architecture string) (Package, error)

Sep 28, 2026

Changes in this version

+ func DesktopFramesClientSource() []byte

type ApplicationPlanOptions

+ BrowserProfileDirectory string

type DesktopConnection

+ func (c *DesktopConnection) StreamVersion() int

type DesktopEvent

+ StreamVersion int

type DesktopFrame

+ Base uint64

+ RegionHeight int

+ RegionWidth int

+ X int

+ Y int

type DesktopRequest

+ Mode string

Sep 27, 2026

Changes in this version

+ func DesktopSelfTest(context.Context, string, string) error — darwin/amd64, js/wasm, windows/amd64

+ func DesktopSelfTest(ctx context.Context, root, architecture string) error — linux/amd64

+ func WriteDesktopLauncher(directory, component, architecture string) (string, error)

+ type DesktopClipboard struct

+ Connection uint64

+ Error string

+ Generation uint64

+ Text *string

+ Window uint64

type DesktopEvent

+ Clipboard *DesktopClipboard

+ type DesktopSessionOptions struct

+ Directory string

+ Environment []string

+ HostBus string

+ InitialDocuments []string

+ Instance string

+ Plan ApplicationLaunchPlan

+ Runtime string

+ type DesktopTools struct

+ Capture string

+ GTKModules string

+ IBusDaemon string

+ IBusPortal string

+ Library string

+ Python string

+ QtPlugins string

+ Root string

+ Shell string

+ Xwayland string

+ func ResolveDesktopTools(root, architecture string) (DesktopTools, error)

+ func (t DesktopTools) Environment(base []string) []string

type Manager

+ func (m *Manager) DesktopBackend() (BackendCapability, error)

+ func (m *Manager) PlanDesktop(ctx context.Context, desktopFile string, environment []string) (ApplicationLaunchPlan, error)

+ func (m *Manager) PrepareDesktopSession(ctx context.Context, options DesktopSessionOptions) (PreparedDesktopSession, error)

type Package

+ Preparation *Preparation

+ func DesktopForPlatform(platform, architecture string) (Package, error)

+ type Preparation struct

+ Contract string

+ NativeSHA256 string

+ type PreparedDesktopSession struct

+ Component string

+ Configuration string

+ Endpoint DesktopEndpoint

+ Executable string

Sep 27, 2026

Changes in this version

+ var ErrDesktopProtocol = errors.New("invalid native desktop helper protocol")

+ func CursorClientSource() []byte

+ func DialDesktop(context.Context, DesktopEndpoint) (*DesktopConnection, DesktopState, error) — darwin/amd64, js/wasm, windows/amd64

+ func DialDesktop(ctx context.Context, endpoint DesktopEndpoint) (*DesktopConnection, DesktopState, error) — linux/amd64

+ type DesktopConnection struct

+ func (c *DesktopConnection) Close() error

+ func (c *DesktopConnection) Connection() uint64

+ func (c *DesktopConnection) Read(ctx context.Context) (DesktopEvent, error)

+ func (c *DesktopConnection) Send(ctx context.Context, request DesktopRequest) (uint64, error)

+ type DesktopCursor struct

+ Connection uint64

+ Encoding string

+ Generation uint64

+ Height int

+ LogicalHeight int

+ LogicalWidth int

+ Mode string

+ Sequence uint64

+ Width int

+ Window uint64

+ XHot float64

+ YHot float64

+ type DesktopEndpoint struct

+ Instance string

+ SocketPath string

+ Token string

+ type DesktopEvent struct

+ Bytes int

+ Code string

+ Connection uint64

+ Cursor *DesktopCursor

+ Error string

+ Event string

+ Frame *DesktopFrame

+ ID uint64

+ Pixels []byte

+ Result json.RawMessage

+ State *DesktopState

+ Version int

+ type DesktopFrame struct

+ Connection uint64

+ Encoding string

+ Generation uint64

+ Height int

+ Sequence uint64

+ Width int

+ Window uint64

+ type DesktopRequest struct

+ Connection uint64

+ Frame uint64

+ Generation uint64

+ Method string

+ Operation json.RawMessage

+ Window uint64

+ type DesktopState struct

+ Generation uint64

+ State string

+ Window uint64

+ Windows []DesktopWindow

+ type DesktopWindow struct

+ Fullscreen bool

+ Height int

+ Interacting bool

+ Maximized bool

+ Minimized bool

+ Parent uint64

+ Protocol string

+ Title string

+ Width int

+ Window uint64

Sep 26, 2026

Changes in this version

+ type PreparedViewer struct

+ func PrepareViewer(source string) (*PreparedViewer, error)

+ func (v *PreparedViewer) Assets() *ClientAssets

+ func (v *PreparedViewer) Document(basePath string) ([]byte, error)

Sep 26, 2026

Changes in this version

+ type ApplicationLaunchPlan struct

+ func PlanApplication(ctx context.Context, options ApplicationPlanOptions) (ApplicationLaunchPlan, error)

+ func (p ApplicationLaunchPlan) Description() ApplicationPlanDescription

+ func (p ApplicationLaunchPlan) Revalidate(ctx context.Context, options ApplicationPlanOptions) error

+ func (p ApplicationLaunchPlan) Write(directory string) (string, error)

+ type ApplicationPackage struct

+ Application string

+ Confinement string

+ Deployment string

+ Format int

+ ID string

+ Kind string

+ Ref string

+ Revision string

+ SecurityTag string

+ Version string

+ type ApplicationPlanDescription struct

+ Backend BackendCapability

+ Desktop string

+ DesktopSHA256 string

+ Package ApplicationPackage

+ SHA256 string

+ Services []string

+ Version int

+ type ApplicationPlanOptions struct

+ Backends []BackendCapability

+ DesktopFile string

+ Environment []string

+ Python string

+ type BackendCapability struct

+ Component string

+ ID string

+ Protocols []string

+ Services []string

+ type LaunchUnavailable struct

+ Code string

+ Stage string

+ func (e *LaunchUnavailable) Error() string

Sep 24, 2026

Changes in this version

type ClientInput

+ GTKPath string

Sep 24, 2026

Changes in this version

+ func WriteBundleWithOptions(ctx context.Context, pkg Package, cacheRoot string, output io.Writer, ...) error

+ func WriteTransferBundleWithOptions(ctx context.Context, pkg Package, plan TransferPlan, cacheRoot string, ...) error

+ type BundleOptions struct

+ CachePolicy artifactcache.Policy

+ Client *http.Client

+ OnMaintenance func(artifactcache.Maintenance, error)

+ OnProgress func(BundleProgress) error

+ type BundleProgress struct

+ CachedBytes *int64

+ ComponentBytes int64

+ DownloadBytes *int64

+ DownloadedBytes int64

+ Phase string

Sep 23, 2026

Changes in this version

+ type ClientAssets struct

+ func OpenClientAssets(directory string) (*ClientAssets, error)

+ func (a *ClientAssets) Digest() string

+ func (a *ClientAssets) RewriteHTML(document []byte, basePath string) ([]byte, error)

+ func (a *ClientAssets) ServeHTTP(w http.ResponseWriter, r *http.Request)

Sep 23, 2026

Changes in this version

+ const ClientInputTextLimit

+ const ClientInputVersion

+ func PrepareInputClient(source, destination string) error

+ func SystemClientInputPython(ctx context.Context, xpra string, environment []string) (string, error)

+ type ClientInput struct

+ GTKModules string

+ Launcher string

+ QtPlugins string

+ func PrepareClientInput(directory, architecture string) (ClientInput, error)

+ func (input ClientInput) XpraArgs(baseEnvironment []string) []string

+ type ClientInputCapability struct

+ Version int

+ XpraVersion string

+ func ProbeClientInput(ctx context.Context, python string, environment []string) (ClientInputCapability, error)

Sep 22, 2026

Changes in this version

+ func WriteTransferBundle(ctx context.Context, pkg Package, plan TransferPlan, cacheRoot string, ...) error

+ type Installation struct

+ Architecture string

+ Contract string

+ Digest string

+ ID string

+ Ready bool

type Manager

+ func (m *Manager) DirectoryFor(digest string) (string, error)

+ func (m *Manager) InstallationForProcess(process ProcessIdentity) (*Installation, error)

+ func (m *Manager) Plan(ctx context.Context) (TransferPlan, error)

type Status

+ InstallationErrorCode string

+ Installed *Installation

+ UpdateAvailable bool

+ type TransferPlan struct

+ Architecture string

+ MissingArtifacts []string

+ MissingBytes int64

+ PackageDigest string

Sep 22, 2026

Changes in this version

+ func WriteApplicationLauncher(directory string) (string, error)

+ func XpraApplicationLifetimeArgs() []string

+ type ProcessIdentity struct

+ Boot string

+ PID int

+ Started string

+ func ObserveProcess(_ int) (ProcessIdentity, error)

+ func ObserveProcess(pid int) (ProcessIdentity, error)

+ func (p ProcessIdentity) Alive() bool

Sep 22, 2026

Changes in this version

+ func XpraNoAudioArgs() []string

Sep 20, 2026

Changes in this version

+ var ErrBusy = errors.New("native preparation is already running")

+ var ErrForbidden = errors.New("native preparation belongs to another caller")

+ var ErrInvalid = errors.New("invalid native preparation request")

+ var ErrUnsupported = errors.New("native graphical components are unavailable for this platform")

+ func SelfTest(parent context.Context, root string) (result error)

+ func WriteBundle(ctx context.Context, pkg Package, cacheRoot string, output io.Writer, ...) error

+ type Artifact struct

+ Format string

+ License string

+ Name string

+ SHA256 string

+ Size int64

+ Source string

+ URL string

+ type Manager struct

+ func New(root string, pkg Package, validate func(context.Context, string) error) (*Manager, error)

+ func (m *Manager) Cancel(owner, id string) (Status, error)

+ func (m *Manager) Close()

+ func (m *Manager) CompleteUpload(owner, id string) (Status, error)

+ func (m *Manager) Directory() (string, error)

+ func (m *Manager) Package() Package

+ func (m *Manager) Snapshot(owner string) Status

+ func (m *Manager) Start(owner, requestID, source string, uploadSize int64) (Status, error)

+ func (m *Manager) Watch() (<-chan struct{}, func())

+ func (m *Manager) WriteChunk(owner, id string, offset int64, data []byte) (Status, error)

+ type Package struct

+ Architecture string

+ Artifacts []Artifact

+ ID string

+ InstalledBytes int64

+ SizeBytes int64

+ func ForPlatform(platform, architecture string) (Package, error)

+ func NativePackage() (Package, error)

+ func (p Package) Digest() string

+ func (p Package) Validate() error

+ type Status struct

+ CanCancel bool

+ ErrorCode string

+ ExpectedBytes int64

+ OperationID string

+ ReceivedBytes int64

+ State string

+ func (s Status) Active() bool

+ type Tools struct

+ DBus string

+ HTML string

+ Python string

+ Root string

+ Xauth string

+ Xpra string

+ Xvfb string

+ func ResolveTools(root string) (Tools, error)

+ func (t Tools) Environment(base []string) []string