https://wiki.archlinux.org/api.php?action=feedcontributions&user=NotAria&feedformat=atomArchWiki - User contributions [en]2024-03-29T14:01:03ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=Plymouth&diff=558320Plymouth2018-12-04T19:10:44Z<p>NotAria: /*Appended another kernel parameter, without "vt.global_cursor_default=0" plymouth will flicker once during boot*/</p>
<hr />
<div>[[Category:Bootsplash]]<br />
[[cs:Plymouth]]<br />
[[es:Plymouth]]<br />
[[fa:Plymouth]]<br />
[[it:Plymouth]]<br />
[[ja:Plymouth]]<br />
[[pt:Plymouth]]<br />
[[ru:Plymouth]]<br />
[[zh-hans:Plymouth]]<br />
[http://www.freedesktop.org/wiki/Software/Plymouth Plymouth] is a project from Fedora providing a flicker-free graphical boot process. It relies on [[kernel mode setting]] (KMS) to set the native resolution of the display as early as possible, then provides an eye-candy splash screen leading all the way up to the login manager.<br />
<br />
== Preparation ==<br />
<br />
''Plymouth'' primarily uses [[KMS]] (Kernel Mode Setting) to display graphics. In EFI/UEFI systems, ''plymouth'' can utilize the EFI framebuffer. If you can't use KMS in e.g. because you are using a proprietary driver, or if you don't want to use EFI framebuffer, consider using [[Uvesafb]] as it works with widescreen resolutions.<br />
<br />
If you have neither KMS nor a framebuffer, ''Plymouth'' will fall back to text-mode.<br />
<br />
== Installation ==<br />
<br />
Plymouth is available from the [[AUR]]: the stable package is {{AUR|plymouth}} and the development version is {{AUR|plymouth-git}}.<br />
<br />
If you also use [[GDM]], you should install the {{AUR|gdm-plymouth}}, which compiles gdm with plymouth support.<br />
<br />
=== The plymouth hook ===<br />
<br />
Add {{ic|plymouth}} to the {{ic|HOOKS}} array in [[mkinitcpio.conf]]. It '''must''' be added '''after''' {{ic|base}} and {{ic|udev}} for it to work:<br />
<br />
{{hc|/etc/mkinitcpio.conf|2=HOOKS="base udev plymouth [...] "}}<br />
<br />
{{Warning|<br />
* If you use [[System Encryption with LUKS for dm-crypt|hard drive encryption]] with the {{ic|encrypt}} hook, you '''must''' replace the {{ic|encrypt}} hook with {{ic|plymouth-encrypt}} in order to get to the TTY password prompts.<br />
* Using {{ic|PARTUUID}} or {{ic|PARTLABEL}} in {{ic|1=cryptdevice=}} parameter does '''not''' work with {{ic|plymouth-encrypt}} hook.<br />
* For a [[Installing Arch Linux on ZFS#Native encryption|ZFS encrypted root]], you '''must''' install {{AUR|plymouth-zfs}} and replace {{ic|zfs}} hook with {{ic|plymouth-zfs}}<br />
}}<br />
<br />
After adding the {{ic|plymouth-encrypt}} hook, if input goes to the background in plaintext instead of into the password prompt you need to add your (kernel) graphics driver to your initramfs. For example, if using intel:<br />
<br />
{{hc|/etc/mkinitcpio.conf|2=MODULES="i915 [...]"}}<br />
<br />
This might also be a step needed for some themes to work.<br />
<br />
=== Alternative plymouth hook (systemd) ===<br />
If your [[mkinitcpio.conf]] includes the {{ic|systemd}} hook, then replace {{ic|plymouth}} with {{ic|sd-plymouth}}. Additionally, if using hard drive encryption, use {{ic|sd-encrypt}} instead of {{ic|encrypt}} or {{ic|plymouth-encrypt}}:<br />
<br />
{{hc|/etc/mkinitcpio.conf|2=HOOKS="base systemd sd-plymouth [...] sd-encrypt [...]"}}<br />
<br />
=== The kernel command line ===<br />
<br />
You now need to set the {{ic|1=quiet splash vt.global_cursor_default=0}} [[kernel parameters]]. See [[Silent boot]] for other parameters to limit the output to the console.<br />
<br />
Rebuild your initrd image (see [[mkinitcpio]] article for details), for example:<br />
<br />
# mkinitcpio -p linux<br />
<br />
== Configuration ==<br />
<br />
=== Smooth transition ===<br />
<br />
To enable ''smooth transition'' (if supported) you have to:<br />
<br />
# [[Disable]] your [[display manager]] unit, e.g. {{ic|gdm.service}}<br />
# [[Enable]] the respective DM-plymouth unit (GDM, LXDM, SLiM, LightDM, SDDM units provided), e.g. {{ic|gdm-plymouth.service}}<br />
<br />
=== Show Delay ===<br />
<br />
Plymouth has a configuration option to delay the splash screen:<br />
{{hc|/etc/plymouth/plymouthd.conf|2=<br />
[Daemon]<br />
Theme=spinner<br />
ShowDelay=5<br />
}}<br />
<br />
On systems that boot quickly, you may only see a flicker of your splash theme before your DM or login prompt is ready. You can set {{ic|ShowDelay}} to an interval (in seconds) longer than your boot time to prevent this flicker and only show a blank screen.<br />
The default is 5 seconds, but you may wish to change this to a lower value to see your splash earlier during boot.<br />
<br />
=== Changing the Theme ===<br />
<br />
Plymouth comes with a selection of themes:<br />
<br />
# '''Fade-in''': "Simple theme that fades in and out with shimmering stars"<br />
# '''Glow''': "Corporate theme with pie chart boot progress followed by a glowing emerging logo"<br />
# '''Script''': "Script example plugin" (Despite the description seems to be a quite nice Arch logo theme)<br />
# '''Solar''': "Space theme with violent flaring blue star"<br />
# '''Spinner''': "Simple theme with a loading spinner" <br />
# '''Spinfinity''': "Simple theme that shows a rotating infinity sign in the center of the screen"<br />
# ''('''Text''': "Text mode theme with tricolor progress bar")''<br />
# ''('''Details''': "Verbose fallback theme")''<br />
<br />
In addition you can install other themes from [[AUR]], just have a look at the "Required by"-Array on {{AUR|plymouth}}.<br />
<br />
All currently installed themes can be listed by using this command:<br />
<br />
$ plymouth-set-default-theme -l<br />
<br />
or:<br />
<br />
{{hc|$ ls /usr/share/plymouth/themes|<br />
details glow solar spinner tribar<br />
fade-in script spinfinity text<br />
}}<br />
<br />
By default, the '''spinner''' theme is selected. The theme can be changed by editing {{ic|/etc/plymouth/plymouthd.conf}}, for example:<br />
<br />
{{hc|/etc/plymouth/plymouthd.conf|2=<br />
[Daemon]<br />
Theme=spinner<br />
ShowDelay=5<br />
}}<br />
<br />
Themes can be previewed without rebuilding, press {{ic|Ctrl+Alt+F2}} to change to console, log in as root and type:<br />
<br />
# plymouthd<br />
# plymouth --show-splash<br />
<br />
To quit the preview, press {{ic|Ctrl+Alt+F2}} again and type:<br />
<br />
# plymouth --quit<br />
<br />
Every time a theme is changed, the kernel image must be rebuilt:<br />
<br />
# plymouth-set-default-theme -R <theme><br />
<br />
Reboot to apply the changes.<br />
<br />
== Tips and tricks ==<br />
<br />
====Show kernel messages====<br />
During boot you can switch to kernel messages by pressing "Home" (or "Escape") key.<br />
<br />
===Replacing the Arch Logo and creating custom themes===<br />
<br />
The following themes use the Arch Linux logo supplied by Plymouth in {{ic|/usr/share/plymouth/arch-logo.png}}: fade-in, script, solar, spinfinity. If you want to use another logo, you can take one of them or one of the plymouth themes in [[AUR]], edit the file {{ic|*.plymouth}} (and maybe {{ic|*.script}}, too) and replace this image with one of your choice. You should create a package from your newly created theme, because changes in {{ic|/usr/share/plymouth}} may not be persistent across package upgrades.<br />
<br />
After installing and selecting your theme, you should rebuild the initrd image to use the new splash.<br />
<br />
== See also ==<br />
<br />
* [http://fedoraproject.org/wiki/Releases/FeatureBetterStartup Original Spec]<br />
* [https://bbs.archlinux.org/viewtopic.php?id=81406 Related forum thread]</div>NotAria