Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

An error occurred while submitting your form. Please try again or file a bug report. Close

Ubuntu Frame snap interfaces

This document provides a reference for the snap interfaces available for Ubuntu Frame.


The current snap interface connections can be checked by issuing:

$ snap connections ubuntu-frame
Interface              Plug                                Slot                                  Notes
content                -                                   ubuntu-frame:ubuntu-frame-diagnostic  -
content[gpu-2404]      ubuntu-frame:gpu-2404               mesa-2404:gpu-2404                    -
desktop-launch         ubuntu-frame:desktop-launch         -                                     -
hardware-observe       ubuntu-frame:hardware-observe       :hardware-observe                     -
login-session-control  ubuntu-frame:login-session-control  -                                     -
network-bind           ubuntu-frame:network-bind           :network-bind                         -
opengl                 ubuntu-frame:opengl                 :opengl                               -
wayland                -                                   ubuntu-frame:wayland                  -
wayland                ubuntu-frame:wayplug                -                                     -
x11                    ubuntu-frame:x11                    :x11                                  -

The above is the default set of connections upon installation. It serves the default use case of Frame running as a system service. You can change the connections through a gadget snap or manually:

sudo snap connect ubuntu-frame:login-session-control

The wayland connection will be automatic if Frame is the only provider of the slot. On Classic systems this slot is provided by snapd, so upon installing a snap that has a plugs: [wayland], a manual connection (to any wayland slot). The same applies if you have multiple snaps that have slots: [wayland] installed on a Core system:

sudo snap connect <snap>:wayland
# or, on Core
sudo snap connect <snap>:wayland <compositor>:wayland

The interface connections serve the following purposes:

Interface Purpose Notes
ubuntu-frame-diagnostic The diagnostic screen feature
graphics-core20 GPU userspace drivers on 20 track
graphics-core22 GPU userspace drivers on 22 track
gpu-2404 GPU userspace drivers on 24 track
hardware-observe Avoiding excessive logging from libinput
login-session-control Running as an unprivileged user Not auto-connected, as the primary way to run Frame is as a system service
network-bind Operate as a X11 server
opengl Access the GPU for hardware acceleration
wayland Act as a Wayland compositor
wayplug Supports the launcher feature
x11 Run nested on a X11 session

Last updated 4 months ago. Help improve this document in the forum.