Jump to content

Plymouth: Difference between revisions

From Official NixOS Wiki
Ardenet (talk | contribs)
Marked this version for translation
Roxwize (talk | contribs)
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:1-->
<!--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>
[<tvar name=1>https://www.freedesktop.org/wiki/Software/Plymouth</tvar> 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 lang="en" dir="ltr">Usage</span> == <!--T:2-->
== Usage == <!--T:2-->


<!--T:3-->
<!--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>
As an example, you can use a boot animation from [<tvar name=1>https://github.com/adi1090x/plymouth-themes</tvar> adi1090x's collection] like so:
</translate>


</translate>
{{file|3={ pkgs, ... }: {
{{file|configuration.nix|nix|<nowiki>
{ pkgs, ... }: {
   boot = {
   boot = {
     plymouth = {
     plymouth = {
       enable = true;
       enable = true;
       theme = "rings";
       theme = "rings";
       themePackages = with pkgs; [
       themePackages = with pkgs; [
         # By default we would install all themes
         # <translate nowrap><!--T:7--> By default we would install all themes</translate>
         (adi1090x-plymouth-themes.override {
         (adi1090x-plymouth-themes.override {
           selected_themes = [ "rings" ];
           selected_themes = [ "rings" ];
Line 25: Line 23:
     };
     };


     # Enable "Silent boot"
     # <translate nowrap><!--T:8--> Enable "Silent boot"</translate>
     consoleLogLevel = 3;
     consoleLogLevel = 3;
     initrd.verbose = false;
     initrd.verbose = false;
     kernelParams = [
     kernelParams = [
       "quiet"
       "quiet"
       "udev.log_level=3"
       "rd.udev.log_level=3"
       "systemd.show_status=auto"
       "rd.systemd.show_status=auto"
     ];
     ];
     # Hide the OS choice for bootloaders.
 
     # It's still possible to open the bootloader list by pressing any key
     # <translate nowrap><!--T:9--> Hide the OS choice for bootloaders.</translate>
     # It will just not appear on screen unless a key is pressed
     # <translate nowrap><!--T:10--> It's still possible to open the bootloader list by pressing any key</translate>
     # <translate nowrap><!--T:11--> It will just not appear on screen unless a key is pressed</translate>
     loader.timeout = 0;
     loader.timeout = 0;
   };
   };
}
}|name=configuration.nix|lang=nix}}
</nowiki>}}


<span lang="en" dir="ltr"><translate><!--T:4-->
<translate>
<!--T:4-->
During the graphical boot process, it is possible to switch to text mode and back by pressing the escape key.
During the graphical boot process, it is possible to switch to text mode and back by pressing the escape key.


<!--T:5-->
<!--T:5-->
If you are using LUKS encryption and the password prompt falls back to text mode, it may help to switch to initrd-systemd mode:</translate></span lang="en" dir="ltr">
If you are using LUKS encryption the password prompt may fall back to text mode. While the default <code>bgrt</code> theme supports graphical password entry, this may not be supported by all themes.
 
</translate>
<syntaxhighlight lang="nix">
boot.initrd.systemd.enable = true;
</syntaxhighlight>
 
<span lang="en" dir="ltr"><translate><!--T:6--> While the default <code>bgrt</code> theme supports graphical password entry, this may not be supported by all themes.</translate></span lang="en" dir="ltr">


[[Category:Booting{{#translation:}}]]
[[Category:Booting]]

Latest revision as of 05:01, 4 June 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"
      "rd.udev.log_level=3"
      "rd.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 the password prompt may fall back to text mode. While the default bgrt theme supports graphical password entry, this may not be supported by all themes.