Plymouth: Difference between revisions

Latest revision as of 11:57, 17 January 2026

Plymouth is an application that runs early in the boot process, providing a graphical boot animation, it is used by most desktop-oriented Linux distributions.

Usage

As an example, you can use a boot animation from adi1090x's collection like so:

❄︎ configuration.nix

{ pkgs, ... }: {
  boot = {

    plymouth = {
      enable = true;
      theme = "rings";
      themePackages = with pkgs; [
        # By default we would install all themes
        (adi1090x-plymouth-themes.override {
          selected_themes = [ "rings" ];
        })
      ];
    };

    # Enable "Silent boot"
    consoleLogLevel = 3;
    initrd.verbose = false;
    kernelParams = [
      "quiet"
      "udev.log_level=3"
      "systemd.show_status=auto"
    ];
    # Hide the OS choice for bootloaders.
    # It's still possible to open the bootloader list by pressing any key
    # It will just not appear on screen unless a key is pressed
    loader.timeout = 0;

  };
}

During the graphical boot process, it is possible to switch to text mode and back by pressing the escape key. If you are using LUKS encryption and the password prompt falls back to text mode, it may help to switch to initrd-systemd mode:

boot.initrd.systemd.enable = true;

While the default bgrt theme supports graphical password entry, this may not be supported by all themes.

@@ Line 1: / Line 1: @@
-[https://www.freedesktop.org/wiki/Software/Plymouth <span lang="zh-cn" dir="ltr">Plymouth</span>] 是一款在引导过程早期阶段运行，以提供图形化启动动画的应用程序，现已被大多数面向桌面的 Linux 发行版所采用。
+<languages/>
-== 用法 ==
+<translate>
+<!--T:1-->
+<span lang="en" dir="ltr">[https://www.freedesktop.org/wiki/Software/Plymouth Plymouth] is an application that runs early in the boot process, providing a graphical boot animation, it is used by most desktop-oriented Linux distributions.</span>
-例如，你可以使用来自 [https://github.com/adi1090x/plymouth-themes adi1090x's collection]  中的一个启动动画，具体操作如下：
+== <span lang="en" dir="ltr">Usage</span> == <!--T:2-->
+<!--T:3-->
+<span lang="en" dir="ltr">As an example, you can use a boot animation from [https://github.com/adi1090x/plymouth-themes adi1090x's collection]  like so:</span>
+</translate>
 {{file|configuration.nix|nix|<nowiki>
 { pkgs, ... }: {
@@ Line 19: / Line 25: @@
      };
-     # Enable "Silent Boot"
+     # Enable "Silent boot"
-     consoleLogLevel = 0;
+     consoleLogLevel = 3;
      initrd.verbose = false;
      kernelParams = [
        "quiet"
-       "splash"
+       "udev.log_level=3"
-      "boot.shell_on_fail"
+       "systemd.show_status=auto"
-      "loglevel=3"
-       "rd.systemd.show_status=false"
-      "rd.udev.log_level=3"
-      "udev.log_priority=3"
      ];
      # Hide the OS choice for bootloaders.
@@ Line 38: / Line 40: @@
    };
 }
-</nowiki>}}
+</nowiki>}}<translate><span lang="en" dir="ltr">During the graphical boot process, it is possible to switch to text mode and back by pressing the escape key.
-[[Category:Booting]]
+If you are using LUKS encryption and the password prompt falls back to text mode, it may help to switch to initrd-systemd mode:</span lang="en" dir="ltr"></translate><syntaxhighlight lang="nix">
+boot.initrd.systemd.enable = true;
+</syntaxhighlight><translate><span lang="en" dir="ltr">While the default <code>bgrt</code> theme supports graphical password entry, this may not be supported by all themes.</span lang="en" dir="ltr"></translate>
+[[Category:Booting{{#translation:}}]]