Your submission was sent successfully! Close

You have successfully unsubscribed! Close

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

Change the splash screen

By default, Ubuntu Core does not display a splash screen when a device is booting or shutting down. However, on Ubuntu Core 22 (and later), a splash screen can be enabled, either to display the built-in Ubuntu Core branding, or to display custom vendor branding or imagery.

Ubuntu Core Splash

Ubuntu Core’s splash screen is based on Ubuntu’s Plymouth-based splash screen implementation. It’s enabled by adding quiet splash as a kernel boot parameter:

quiet splash

On Ubuntu Core 22 and later, when using the default GNU GRUB bootloader, kernel boot parameters can be configured either in the Gadget snap, or through system options. See Modifying kernel boot parameters for further details on each process.

Customised splash screen

The splash screen can be customised in two different ways, either by including a new logo or image file, or by completely replacing the Plymouth theme used to generate the splash screen.

Ubuntu Core vendor splash screen,  50%

A PNG-formatted vendor logo, or any other PNG-formatted image, can be placed within a new /splash directory in the root of the Gadget snap. The image file must be called vendor-logo.png:

.
├── cmdline.extra
├── grub.conf
├── grubx64.efi
├── meta
│   ├── gadget.yaml
│   ├── gui
│   ├── hooks
│   │   └── configure
│   └── snap.yaml
├── pc-boot.img
├── pc-core.img
├── shim.efi.signed
├── snap
│   ├── command-chain
│   │   └── snapcraft-runner
│   └── hooks
│       └── configure
└── splash
   └── vendor-logo.png

The image will be scaled accordingly and images with a 2:1 aspect ratio work best (such as images with resolution of 800x400). Larger files will obviously increase the size of the gadget snap and the resulting Ubuntu Core image.

Replacement Plymouth theme

The most flexible way to change the appearance of the Ubuntu Core splash screen is to install a replacement Plymouth theme.

While Plymouth itself supports a variety of different splash plugins, Ubuntu Core’s implementation only supports its Scripts (script.so) plugin. This is the most flexible plugin as it provides its own feature-rich scripting language.

A new theme must be placed within a /splash/plymouth/themes/vendor directory in the root of the Gadget snap:

$GADGET/splash/plymouth/themes/vendor/

Pathnames specified in a custom Plymouth config file need to use the prefix /run/mnt/gadget/splash/ rather than /snap/gadget-snap/current/splash/ as the former is mounted in the initramfs before Plymouth is starts, whereas the latter is not.

It can also help to lower the kernel console logging verbosity by specifying loglevel=3 (or lower) on the kernel command line. See Customise the kernel command line for further details.

A good custom Plymouth theme example for Ubuntu Core is its own default theme:
https://github.com/snapcore/core-splash

Note that the configuration file inside the vendor/ directory must be named vendor.plymouth. Configuration inside will point to the script file.

See Building a gadget snap for details on how to create a custom gadget snap.

This page was last modified 8 months ago. Help improve this document in the forum.