Gentoo Wiki


This article is part of the HOWTO series.
Installation Kernel & Hardware Networks Portage Software System X Server Gaming Non-x86 Emulators Misc



After you have setup Fbsplash, you may want to have your own, personalized theme instead of the emergence or gentoo themes that are supplied with media-gfx/splashutils. This HOWTO describes how to do exactly that. This article was pulled from the Fbsplash article and was not originally written by me. Thank you to anybody who contributed to that portion of the original article.

Create A Theme

The standard splash themes are located in /etc/splash/. If you want to create your own theme, you must perform the following steps. For the purpose of this document, let's call the theme 'newtheme.' Replace the word 'newtheme' with the title of your own theme wherever appropriate.


First, create the new directory for your theme.

# mkdir /etc/splash/newtheme

Second, create the images directory where your theme's images will be held.

# mkdir /etc/splash/newtheme/images

Now, copy the image files you would like to use to the images directory.

The next step is to create the necessary config files that define aspects of the theme. The config files should have a *.cfg extension and must be saved in the root path of the theme (/etc/splash/newtheme/). To get an idea for the config file layout, check out the emergence config files in /etc/splash/emergence. It is particularly important to make sure the 'jpeg=' and 'silentjpeg=' options (in the *.cfg files) point to the correct image paths inside the /etc/splash/newtheme/images directory. If you don't use jpeg images, change the jpeg options in 'pic=' and 'silentpic=.'

For a more in-depth understanding of the fbsplash theme format, please refer to splashutils' documentation:

# zless /usr/share/doc/splashutils-version/theme_format.gz

Using the Theme

To generate a new image from the theme you've just created (called 'newtheme', using the 1280x1024 resolution), you will have to use splash_geninitramfs.

If you decided to compile the image into the kernel:

# splash_geninitramfs -v -g /usr/src/linux/usr/initramfs_data.cpio.gz -r 1280x1024 newtheme
# cd /usr/src/linux
# touch usr/initramfs_data.cpio.gz
# make bzImage
# mount /boot
# make install

If you use the initrd file:

# mount /boot
# splash_geninitramfs -v -g /boot/fbsplash-newtheme-1280x1024 -r 1280x1024 newtheme

The last point in this part of the how-to is a useful tip from the splashutils' docs:

If you want to save some memory and you aren't planning to use all available resolutions, you'd probably want to copy the config file and the background pics only for the one resolution you use.

See also

Retrieved from ""

Last modified: Thu, 04 Sep 2008 06:10:00 +0000 Hits: 26,398