home | blog | art | now | git gpg | email | rss

splashdown

Minimal bootsplash program
git clone https://pollux.codes/git/splashdown.git
Log | Files | Refs | README | LICENSE

README.md (1392B)


splashdown - minimal bootsplash program

splashdown is a minimal, daemon-less bootsplash program. When called, it draws a user-specified image to the framebuffer and renders text from the command line on top of it.

Requirements

To build, splashdown depends on freetype2 and libjpeg-turbo.

librc is also required if using the included openrc plugin

Installation

Copy config.def.h to config.h, then edit it and config.mk to your liking. To build and install splashdown, use make and copy the resulting executable to your path.

From this point, the exact means of using splashdown during bootup and shutdown varies significantly between systems. It is recommended to use a custom initramfs and call splashdown after each phase of the boot process.

It is also recommended to use chvt to switch to a dedicated tty for splashdown, and to pass console=tty to the kernel to put boot messages on a separate tty (so they don't overwrite splashdown).

If using openrc, the openrc plugin can be used to preserve splashdown through the openrc service initialization process and to also show it during shutdown. To install the plugin, run "make plugin" and copy the resulting shared object file to the openrc plugin directory.

Acknowledgements