fbs view README @ rev 3

fbsplash freezes its progressbar if fifo isn't a real fifo but plain file
author Aleksej Bobylev <al.bobylev@gmail.com>
date Fri May 02 11:23:55 2014 +0000 (2014-05-02)
parents 8bb34ff7b4c0
children
line source
1 Fbs - Framebuffer Boot Splash toolkit
2 ================================================================================
5 Fbs is a rewrite of the old SliTaz Fbsplash tool for the SliTaz ARM and
6 Raspberry Pi flavors. SliTaz ARM uses radically simple boot scripts so
7 the integration was very easy. Enabling/disabling fbsplash on boot and
8 managing themes can be done with the fbs utility.
10 In time or if someone gives a hand. It may be possible to have a
11 GTK or/and Ncurses frontend to handle themes.
14 Overview
15 --------
17 * Use Busybox fbsplash applet for image and progress bar
18 * Use Linux kernel options 'quiet' at boot time
19 * Enable FBSPLASH in /etc/rcS.conf config file
20 * Tweak /etc/inittab to hide and log text messages
21 * The SliTaz theme can fit in a very small screen since the image
22 goes top/left and has a black bg such as the Linux Framebuffer
25 Install & setup
26 ---------------
27 Fbs is packaged for SliTaz but should work on any GNU/Linux with some
28 modifications to the boot scripts, patches are welcome! To install the
29 fbs utility and default theme:
31 # make && make install
33 Boot splash is activated on some SliTaz ARM flavors but not on the i486
34 standard distribution so you need enable fbs to have a graphical boot:
36 # fbs on [theme]
38 All fbs configuration variables can be found in: /etc/rcS.conf. These are:
40 FBSPLASH="on"
41 FBTHEME="slitaz"
43 Testing
44 -------
45 Let's test the environment, first make sure you have the Linux Framebuffer
46 device node with: 'ls /dev/fb0'. The Raspberry Pi uses the Linux framebuffer
47 so Fbs will work out of the box.
49 Then press Ctrl+Alt+F2 to open a text mode session (back to X with Alt+F7)
50 and run as root the Fbs testsuite:
52 # fbs test
54 Theming
55 -------
56 Fbs provide a nifty theming mechanism designed to easily handle installed
57 themes as well has creating and sharing new themes. A theme exists in
58 a small and human readable configuration and in a gzip ppm image.
60 # fbs themes
61 # fbs set-theme [theme]
62 # fbs pack-theme [theme]
63 # fbs add-theme [theme]
65 Code example
66 ------------
67 #!/bin/sh
68 #
69 export fifo=/tmp/fbs.fifo
70 rm -f $fifo; mkfifo $fifo
72 fbsplash -c -f ${fifo} \
73 -s /usr/share/fbs/default/fbsplash.ppm.gz \
74 -i /usr/share/fbs/default/fbsplash.cfg &
76 echo 25 > ${fifo}
77 sleep 1
78 echo 50 > ${fifo}
79 sleep 1
80 echo 75 > ${fifo}
81 sleep 1
82 echo "exit" > ${fifo}
84 ===============================================================================