Fbs - Framebuffer Boot Splash toolkit
================================================================================


Fbs is a rewrite of the old SliTaz Fbsplash tool for the SliTaz ARM and
Raspberry Pi flavors. SliTaz ARM uses radically simple boot scripts so
the integration was very easy. Enabling/disabling fbsplash on boot and
managing themes can be done with the fbs utility.

In time or if someone gives a hand. It may be possible to have a
GTK or/and Ncurses frontend to handle themes.


Overview
--------

 * Use Busybox fbsplash applet for image and progress bar
 * Use Linux kernel options 'quiet' at boot time
 * Enable FBSPLASH in /etc/rcS.conf config file
 * Tweak /etc/inittab to hide and log text messages
 * The SliTaz theme can fit in a very small screen since the image
   goes top/left and has a black bg such as the Linux Framebuffer


Install & setup
---------------
Fbs is packaged for SliTaz but should work on any GNU/Linux with some
modifications to the boot scripts, patches are welcome! To install the
fbs utility and default theme: 

# make && make install

Boot splash is activated on some SliTaz ARM flavors but not on the i486
standard distribution so you need enable fbs to have a graphical boot:

# fbs on [theme]

All fbs configuration variables can be found in: /etc/rcS.conf. These are:

FBSPLASH="on"
FBTHEME="slitaz"

Testing
-------
Let's test the environment, first make sure you have the Linux Framebuffer
device node with: 'ls /dev/fb0'. The Raspberry Pi uses the Linux framebuffer
so Fbs will work out of the box.

Then press Ctrl+Alt+F2 to open a text mode session (back to X with Alt+F7)
and run as root the Fbs testsuite:

# fbs test

Theming
-------
Fbs provide a nifty theming mechanism designed to easily handle installed
themes as well has creating and sharing new themes. A theme exists in
a small and human readable configuration and in a gzip ppm image.

# fbs themes
# fbs set-theme [theme]
# fbs pack-theme [theme]
# fbs add-theme [theme]

Code example
------------
#!/bin/sh
#
export fifo=/tmp/fbs.fifo
rm -f $fifo; mkfifo $fifo

fbsplash -c -f ${fifo} \
	-s /usr/share/fbs/default/fbsplash.ppm.gz \
	-i /usr/share/fbs/default/fbsplash.cfg &

echo 25 > ${fifo}
sleep 1
echo 50 > ${fifo}
sleep 1
echo 75 > ${fifo}
sleep 1
echo "exit" > ${fifo}

===============================================================================