Differences between revisions 24 and 25
Revision 24 as of 2019-06-27 08:12:43
Size: 3575
Editor: PaulWise
Comment: plymouth-dr is long ago merged into plymouth
Revision 25 as of 2020-05-18 10:28:19
Size: 6546
Comment: Major page rewrite and cleanup. All supported Debian versions now have KMS enabled in each of the open-source drivers by default.
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
Plymouth presents a graphic animation (also known as bootsplash) while the boot process is occurring in the background. It is designed to be used with the Direct Rendering Manager (DRM) modesetting drivers. For systems that don't have DRM mode settings drivers, plymouth falls back to text mode - it can also use a legacy /dev/fb interface using a variation of these instructions (yet to be added). Plymouth presents a graphic animation (also known as a bootsplash) while the system boots. It provides eye-candy and a more professional presentation for scenarios where the default high-information text output might be undesirable. It also handles boot prompts, such as entering disk encryption passwords.

== Preinstallation ==

Before installing, check that the driver you're using for your card supports kernel modesetting (KMS) which is required for Plymouth to function:

 * ATI/AMD - Supported and automatically enabled by the Radeon and AMDGPU drivers that are used for any recent card. Support unknown for very old ATI cards.

 * NVIDIA - Supported by the Nouveau driver and the proprietary driver, enabled by default in Nouveau but must be manually enabled with the proprietary driver.

 * Intel - Supported and enabled in the DebPkg:xserver-xorg-video-intel driver and the (preferred) modesetting driver that is used if that package is not installed.

 * Mali - Supported and enabled in the Lima and Panfrost drivers available in [[DebianBullseye|Debian 11/Bullseye]] and newer. Support in the proprietary driver is unknown.
Line 12: Line 24:
Before installing, check the manufacturer website if your graphics card drivers support modesetting or check the project page of the free/open drivers for your graphics card. {{{#}}} indicates a command must be run as root. Omit if signed in as root, otherwise replace with {{{sudo}}}.
Line 14: Line 26:
=== Wheezy, Jessie, Stretch === To install Plymouth and its base set of themes, run:
{{{
# apt install plymouth plymouth-themes
}}}
Line 16: Line 31:
If using Debian with KDE Plasma in Buster or newer, you may also want to install the KDE Breeze Plymouth theme and an easy integrated configuration module for Plymouth with:
Line 17: Line 33:
# apt-get install plymouth plymouth-themes}}} # apt install plymouth-theme-breeze kde-config-plymouth
}}}
Line 19: Line 36:
or If you run into any issues trying to set the theme, or if it doesn't appear, you may need to install the proprietary GPU firmware. This is especially likely on AMD cards. Enable the {{{contrib}}} and {{{non-free}}} sections in your [[SourcesList]] file and run:
{{{
# apt install firmware-linux
}}}
Line 21: Line 41:
== Enabling KMS (NVIDIA Proprietary) ==

All drivers included in Debian automatically enable kernel modesetting except for the proprietary NVIDIA driver, which requires an additional kernel parameter to be added. The easiest way to do this is to open {{{/etc/default/grub}}} in your text editor with choice. This file requires administrative permissions to edit, so you can may launch your text editor as root using {{{sudo}}}, run it while logged in as root, or use a text editor that supports !PolKit such as Kate/KWrite which can edit the file without special permissions.

Within the quotes on the line that starts with {{{GRUB_CMDLINE_LINUX_DEFAULT}}}, add the option {{{nvidia-drm.modeset=1}}}. The final line may look similar to:
Line 22: Line 47:
# aptitude install plymouth plymouth-themes}}} GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvidia-drm.modeset=1
}}}

Afterwards, apply the change by running:
{{{
# update-grub2
}}}
After which, rebooting will load the driver with proper modesetting.

'''WARNING:''' With some versions of the NVIDIA driver prior to [[DebianBullseye|Debian 11/Bullseye]], there may be a bug that can cause a blank screen on some DisplayPort-connected monitors whenever logging in to GNOME while modesetting is enabled.
Line 26: Line 60:
Edit the file `/etc/initramfs-tools/modules` and add the modesetting for your graphics card: Please edit the file {{{/etc/default/grub}}} and change the resolution. To do that, search for the line {{{#GRUB_GFXMODE=640x480}}} and remove the {{{#}}} at the start to uncomment it. You can then set it to match the resolution of your monitor.
Line 28: Line 62:
For Intel: For example, on a standard 1080p screen:
Line 30: Line 64:
# KMS
intel_agp
drm
i915 modeset=1}}}

For Nouveau (nVidia):
{{{
# KMS
drm
nouveau modeset=1}}}

For ATI:
{{{
# KMS
drm
radeon modeset=1
GRUB_GFXMODE=1920x1080
Line 48: Line 67:
Next, you need to configure the bootloader (Grub2) in order to set the desired resolution and to enable the bootsplash.
=== Grub2 ===
You can also write the color depth:
{{{
GRUB_GFXMODE=1920x1080x32
}}}
Line 51: Line 72:
Please edit the file `/etc/default/grub` and change the resolution. To do that, search for the line `#GRUB_GFXMODE=640x480` and uncomment it. You can set the resolution which is best for your monitor.

For example:
{{{
GRUB_GFXMODE=1024x768}}}

In netbooks you can put 1024x600 or 1024x576. For example:
{{{
GRUB_GFXMODE=1024x576}}}

You can also write the color depth. For example:
{{{
GRUB_GFXMODE=1024x576x32}}}

Please also search for and edit the line `GRUB_CMDLINE_LINUX_DEFAULT="quiet"` and change it to:
If your {{{GRUB_CMDLINE_LINUX_DEFAULT}}} does not contain a {{{splash}}} option, add it like so:
Line 68: Line 75:
Take care to not remove or modify the modesetting line for the NVIDIA proprietary driver if you had previously added it.
Line 69: Line 77:
Finally, update Grub2:
Finally, apply the change by running:
Line 72: Line 79:
# update-grub2}}} # update-grub2
}}}
Line 76: Line 84:
As root run the next commands.
To display all installed themes run:
If you're using KDE Plasma and have installed the DebPkg:kde-config-plymouth package, terminal commands are not necessary to view and set your Plymouth theme. The "Boot Splash Screen" panel in your system settings will allow you to do the same. In this case, the "Breeze" theme is also recommended for aesthetic consistency.
Line 79: Line 86:
Otherwise, to display all installed themes, run:
Line 80: Line 88:
# plymouth-set-default-theme -l}}} # plymouth-set-default-theme -l
}}}
Line 82: Line 91:
Default output will be:- The default output will be:
Line 97: Line 106:
{{{
# plymouth-set-default-theme -R THEME
}}}
Where {{{THEME}}} refers to one of the listed values from the executed command.
Line 98: Line 111:
{{{
# plymouth-set-default-theme -R THEME}}}
== Troubleshooting ==
Line 101: Line 113:
THEME refers to one of the listed values from the executed command. If you still are having issues after installing the proprietary firmware and otherwise verifying that there's nothing that should be preventing Plymouth from functioning correctly, it's likely there is an issue with the kernel modesetting.
Line 103: Line 115:
If this command errors out with a message saying that firmware files are missing, you will have to install the package DebianPkg:firmware-linux-nonfree. To do that, execute the following command: You can follow the instructions for enabling modesetting in the NVIDIA Proprietary driver but change the option to forcibly enable it in other drivers.
Line 105: Line 117:
{{{
# apt-get install firmware-linux-nonfree}}}
For Nouveau, the option is {{{nouveau.modeset=1}}}.
Line 108: Line 119:
or For AMD, the option is {{{radeon.modeset=1}}} when using the {{{radeon}}} driver and {{{amdgpu.modeset=1}}} when using the {{{amdgpu}}} driver.
Line 110: Line 121:
{{{
# aptitude install firmware-linux-nonfree}}}

And repeat the process to set the theme.
If issues are experienced on Intel, you are recommended to remove the DebPkg:xserver-xorg-video-intel package entirely and use the internal {{{modesetting}}} driver for display. Otherwise, if you require the package, you might add the {{{i915.modeset=1}}} option.
Line 117: Line 124:
1. During boot, you can press the "Home" key to view the underlying messages (kernel, messages from the startup scripts, services, etc.).  * During boot, you can press the "Home" or "Escape" keys to view the underlying messages (kernel, messages from the startup scripts, services, etc.).

Translation(s): English - Español - Français - Italiano - ?Português - Русский


Plymouth

Plymouth presents a graphic animation (also known as a bootsplash) while the system boots. It provides eye-candy and a more professional presentation for scenarios where the default high-information text output might be undesirable. It also handles boot prompts, such as entering disk encryption passwords.

Preinstallation

Before installing, check that the driver you're using for your card supports kernel modesetting (KMS) which is required for Plymouth to function:

  • ATI/AMD - Supported and automatically enabled by the Radeon and AMDGPU drivers that are used for any recent card. Support unknown for very old ATI cards.
  • NVIDIA - Supported by the Nouveau driver and the proprietary driver, enabled by default in Nouveau but must be manually enabled with the proprietary driver.
  • Intel - Supported and enabled in the xserver-xorg-video-intel driver and the (preferred) modesetting driver that is used if that package is not installed.

  • Mali - Supported and enabled in the Lima and Panfrost drivers available in Debian 11/Bullseye and newer. Support in the proprietary driver is unknown.

Installation

# indicates a command must be run as root. Omit if signed in as root, otherwise replace with sudo.

To install Plymouth and its base set of themes, run:

# apt install plymouth plymouth-themes

If using Debian with KDE Plasma in Buster or newer, you may also want to install the KDE Breeze Plymouth theme and an easy integrated configuration module for Plymouth with:

# apt install plymouth-theme-breeze kde-config-plymouth

If you run into any issues trying to set the theme, or if it doesn't appear, you may need to install the proprietary GPU firmware. This is especially likely on AMD cards. Enable the contrib and non-free sections in your SourcesList file and run:

# apt install firmware-linux

Enabling KMS (NVIDIA Proprietary)

All drivers included in Debian automatically enable kernel modesetting except for the proprietary NVIDIA driver, which requires an additional kernel parameter to be added. The easiest way to do this is to open /etc/default/grub in your text editor with choice. This file requires administrative permissions to edit, so you can may launch your text editor as root using sudo, run it while logged in as root, or use a text editor that supports PolKit such as Kate/KWrite which can edit the file without special permissions.

Within the quotes on the line that starts with GRUB_CMDLINE_LINUX_DEFAULT, add the option nvidia-drm.modeset=1. The final line may look similar to:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvidia-drm.modeset=1

Afterwards, apply the change by running:

# update-grub2

After which, rebooting will load the driver with proper modesetting.

WARNING: With some versions of the NVIDIA driver prior to Debian 11/Bullseye, there may be a bug that can cause a blank screen on some ?DisplayPort-connected monitors whenever logging in to GNOME while modesetting is enabled.

Configuration

Please edit the file /etc/default/grub and change the resolution. To do that, search for the line #GRUB_GFXMODE=640x480 and remove the # at the start to uncomment it. You can then set it to match the resolution of your monitor.

For example, on a standard 1080p screen:

GRUB_GFXMODE=1920x1080

You can also write the color depth:

GRUB_GFXMODE=1920x1080x32

If your GRUB_CMDLINE_LINUX_DEFAULT does not contain a splash option, add it like so:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"

Take care to not remove or modify the modesetting line for the NVIDIA proprietary driver if you had previously added it.

Finally, apply the change by running:

# update-grub2

Themes

If you're using KDE Plasma and have installed the kde-config-plymouth package, terminal commands are not necessary to view and set your Plymouth theme. The "Boot Splash Screen" panel in your system settings will allow you to do the same. In this case, the "Breeze" theme is also recommended for aesthetic consistency.

Otherwise, to display all installed themes, run:

# plymouth-set-default-theme -l

The default output will be:

# plymouth-set-default-theme -l
details
fade-in
glow
script
solar
spinfinity
spinner
text
tribar

Then, to set your desired theme run:

# plymouth-set-default-theme -R THEME

Where THEME refers to one of the listed values from the executed command.

Troubleshooting

If you still are having issues after installing the proprietary firmware and otherwise verifying that there's nothing that should be preventing Plymouth from functioning correctly, it's likely there is an issue with the kernel modesetting.

You can follow the instructions for enabling modesetting in the NVIDIA Proprietary driver but change the option to forcibly enable it in other drivers.

For Nouveau, the option is nouveau.modeset=1.

For AMD, the option is radeon.modeset=1 when using the radeon driver and amdgpu.modeset=1 when using the amdgpu driver.

If issues are experienced on Intel, you are recommended to remove the xserver-xorg-video-intel package entirely and use the internal modesetting driver for display. Otherwise, if you require the package, you might add the i915.modeset=1 option.

Tips & Tricks

  • During boot, you can press the "Home" or "Escape" keys to view the underlying messages (kernel, messages from the startup scripts, services, etc.).