Difference between revisions of "Splashy"

From ArchWiki
Jump to: navigation, search
(Configuration)
(A lot of random fixes.)
Line 2: Line 2:
 
[[Category: Eye candy (English)]]
 
[[Category: Eye candy (English)]]
 
{{i18n|Splashy}}
 
{{i18n|Splashy}}
{{Out of date}}
 
  
==Introduction==
 
 
[http://splashy.alioth.debian.org Splashy] is a userspace implementation of a splash screen for Linux systems. It provides a graphical environment during system boot using the Linux framebuffer layer via [http://www.directfb.org directfb].
 
[http://splashy.alioth.debian.org Splashy] is a userspace implementation of a splash screen for Linux systems. It provides a graphical environment during system boot using the Linux framebuffer layer via [http://www.directfb.org directfb].
 
Please see [http://bbs.archlinux.org/viewtopic.php?id=48978 this post] on the Arch Linux forum for a repo you can add with working splashy packages.  Splashy in AUR also works (see below).
 
  
 
==Installation==
 
==Installation==
  
# Grab [http://aur.archlinux.org/packages.php?ID=27916 splashy-full] from the [[AUR]]. Instructions on installing packages from the AUR are available [[AUR_User_Guidelines#Installing_Packages_from_the_AUR|here]].
+
Before you can use Splashy, you should enable [[Kernel Mode Setting]]. Please refer to the specific instructions for [[ATI#AMD.2FAti_cards_and_KernelModeSetting_.28KMS.29|ATI cards]], [[Intel#KMS_.28Kernel_Mode_Setting.29|Intel cards]] or [[Nouveau#KMS|Nvidia cards]]. All of these require you to rebuild your kernel image. You will also have to do that later on in this article, so you may wish to skip that step for now.
  
==Configuration==
+
If you don't have KMS you will need to use [[Framebuffer#Framebuffer_Resolution|framebuffer]] instead. Uvesafb is recommended. Of all the three the regular framebuffer is the only one that does not support custom resolutions (including wide screen splashes).
=== Default Framebuffer ===
+
If your hardware does not support Uvesafb this will have to do.
+
  
# [http://en.wikipedia.org/wiki/VESA_BIOS_Extensions#Linux_video_mode_numbers Find the kernel framebuffer mode number closest as possible to your monitor].
+
Grab [http://aur.archlinux.org/packages.php?ID=27916 splashy-full] from the [[AUR]]. Instructions on installing packages from the AUR are available [[AUR_User_Guidelines#Installing_Packages_from_the_AUR|here]].
# Add <code>quiet vga='''mode_number''' splash</code> to your kernel command line in ''/boot/grub/menu.lst''. <br>Example: <code>kernel (hd0,6)/vmlinuz26 root=/dev/sda6 ro '''quiet vga=791 splash'''</code>
+
  
It is recommended to use [[Uvesafb]] if your hardware supports it. This allows you to use the exact native resolution of your monitor (including wide screen splashes).
+
You may also check out [http://bbs.archlinux.org/viewtopic.php?id=48978 this topic] on the [https://bbs.archlinux.org/ Arch Linux forum] for a repo you can add with working splashy packages.
  
If you have a chipset that supports kernel mode setting ([[KMS]]), this is preferable to using Uvesafb.
+
==Configuration==
  
# Add <code>quiet splash</code> to your kernel command line in ''/boot/grub/menu.lst''. <br>Example: <code>kernel (hd0,6)/vmlinuz26 root=/dev/sda6 ro '''quiet splash'''</code>
+
===/etc/rc.conf===
  
=== Other Configuration Files ===
+
Add this in {{Filename|/etc/[[rc.conf]]}}:
====/etc/rc.conf====
+
Add this in {{Filename|/etc/[[rc.conf]]}}, e.g.:
+
 
  SPLASH="splashy"
 
  SPLASH="splashy"
  
====/etc/mkinitcpio.conf====
+
===Including Splashy in the Initcpio===
'''Remember to rebuild the initramfs image whenever Splashy's config changes.''' (E.g. Splashy theme was changed.)
+
 
'''Install any themes before running this to prevent form having to do this twice!
+
Add Splashy to the HOOKS array in [[mkinitcpio.conf]]. It '''must''' be added ''after'' '''base''', '''udev''' and '''autodetect''' for it to work:
#Add '''<code>splashy</code>''' at the '''end''' of the HOOKS in ''/etc/mkinitcpio.conf'', e.g.:<pre>HOOKS="base udev autodetect ide sata filesystems ... splashy"</pre>
+
# nano /etc/mkinitcpio.conf
#Rebuild initramfs image<pre># mkinitcpio -p <kernel name></pre>E.g.<pre># mkinitcpio -p kernel26</pre>
+
 
 +
For early KMS start add the module [[radeon]] (for radeon cards), [[Intel|i915]] (for intel cards) or [[nouveau]] (for nvidia cards) to the MODULES line in {{Filename|/etc/mkinitcpio.conf}}:
 +
 
 +
# nano /etc/mkinitcpio.conf
 +
 
 +
MODULES="i915"
 +
 
 +
MODULES="radeon"
 +
 
 +
MODULES="nouveau"
 +
 
 +
Add '''splashy''' to the HOOKS array:
 +
HOOKS="base udev autodetect splashy ..."
 +
 
 +
Rebuild your kernel image (refer to the [[mkinitcpio]] article for more info):
 +
# mkinitcpio -p [name of your kernel preset]
  
 
===The kernel command line===
 
===The kernel command line===
 +
 
You now need to set '''quiet splash''' as you kernel command line parametres in your bootloader. The following is an example for [[Grub2]] and {{Filename|/boot/grub/grub.cfg}} (the legacy [[Grub]] and [[Lilo]] follow the same pattern):
 
You now need to set '''quiet splash''' as you kernel command line parametres in your bootloader. The following is an example for [[Grub2]] and {{Filename|/boot/grub/grub.cfg}} (the legacy [[Grub]] and [[Lilo]] follow the same pattern):
 
  linux /boot/vmlinuz26 root=/dev/... ro quiet splash
 
  linux /boot/vmlinuz26 root=/dev/... ro quiet splash
Line 51: Line 58:
  
 
===Themes===
 
===Themes===
You can install [http://aur.archlinux.org/packages.php?ID=19626 splashy-themes] in AUR to get a nice splashy theme.   After installing, look at the available themes like so:
+
 
 +
You can install [http://aur.archlinux.org/packages.php?ID=19626 splashy-themes] in AUR to get a nice splashy theme. After installing, look at the available themes like so:
 
  $ ls /usr/share/splashy/themes
 
  $ ls /usr/share/splashy/themes
The folder name is the theme name.   Now edit '''/etc/splashy/config.xml''' and change the theme name to the one you want.  Note that themes ending in 43 are 4:3 aspect ratio, and the others are widescreen.  Try "archlinux-simplyblack" as a good first theme, e.g.:
+
 
 +
The folder name is the theme name. Now edit {{Filename|/etc/splashy/config.xml}} and change the theme name to the one you want, eg.:
 
  <current_theme>archlinux-simplyblack</current_theme>
 
  <current_theme>archlinux-simplyblack</current_theme>
Rebuild your kernel image (refer to the [[mkinitcpio]] article for more info):
+
 
 +
{{Note|Themes ending in 43 are of 4:3 aspect ratio - the others are widescreen.}}
 +
 
 +
Rebuild your kernel image with:
 
  # mkinitcpio -p [name of your kernel preset]
 
  # mkinitcpio -p [name of your kernel preset]
  
==Known Problems==
+
and reboot.
 +
 
 +
==Troubleshooting==
 +
 
 
{{Poor writing}}
 
{{Poor writing}}
 
#Splashy doesn't terminate or automatically switch to verbose mode if an error occurs or when an init script fails. '''No longer true with splashy-full package.'''
 
#Splashy doesn't terminate or automatically switch to verbose mode if an error occurs or when an init script fails. '''No longer true with splashy-full package.'''
Line 68: Line 83:
 
#If you use gsplashy and a theme does not appear on the list, make sure that config.xml in the folder of the theme is named theme.xml instead
 
#If you use gsplashy and a theme does not appear on the list, make sure that config.xml in the folder of the theme is named theme.xml instead
 
#If you get a libz.so.1 error, try either symlinking /lib/libz.so.1 to /usr/lib/libz.so.1 or changing /lib/libz.so.1 to /usr/libz.so.1 in /lib/initcpio/install/splashy
 
#If you get a libz.so.1 error, try either symlinking /lib/libz.so.1 to /usr/lib/libz.so.1 or changing /lib/libz.so.1 to /usr/libz.so.1 in /lib/initcpio/install/splashy
#If you are using Gnome, and are starting GDM as a daemon, Splashy causes Gnome to not be able to properly shutdown/reboot. To fix this issue, remove GDM as a daemon from /etc/rc.conf, and set up GDM with the [http://wiki.archlinux.org/index.php/GDM#inittab_method /etc/inittab file]. This could possibly work with other display managers, but I can only confirm that this works with GDM.
+
#If you are using Gnome, and are starting GDM as a daemon, Splashy causes Gnome to not be able to properly shutdown/reboot. To fix this issue, remove GDM as a daemon from /etc/rc.conf, and set up GDM with the [http://wiki.archlinux.org/index.php/GDM#inittab_method /etc/inittab file]. This could possibly work with other display managers, but I can only confirm that this works with GDM.
  
 
==Links==
 
==Links==
 +
 
* http://splashy.alioth.debian.org
 
* http://splashy.alioth.debian.org
 
* http://www.directfb.org
 
* http://www.directfb.org

Revision as of 12:22, 11 August 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Splashy is a userspace implementation of a splash screen for Linux systems. It provides a graphical environment during system boot using the Linux framebuffer layer via directfb.

Installation

Before you can use Splashy, you should enable Kernel Mode Setting. Please refer to the specific instructions for ATI cards, Intel cards or Nvidia cards. All of these require you to rebuild your kernel image. You will also have to do that later on in this article, so you may wish to skip that step for now.

If you don't have KMS you will need to use framebuffer instead. Uvesafb is recommended. Of all the three the regular framebuffer is the only one that does not support custom resolutions (including wide screen splashes).

Grab splashy-full from the AUR. Instructions on installing packages from the AUR are available here.

You may also check out this topic on the Arch Linux forum for a repo you can add with working splashy packages.

Configuration

/etc/rc.conf

Add this in Template:Filename:

SPLASH="splashy"

Including Splashy in the Initcpio

Add Splashy to the HOOKS array in mkinitcpio.conf. It must be added after base, udev and autodetect for it to work:

# nano /etc/mkinitcpio.conf

For early KMS start add the module radeon (for radeon cards), i915 (for intel cards) or nouveau (for nvidia cards) to the MODULES line in Template:Filename:

# nano /etc/mkinitcpio.conf
MODULES="i915"
MODULES="radeon"
MODULES="nouveau"

Add splashy to the HOOKS array:

HOOKS="base udev autodetect splashy ..."

Rebuild your kernel image (refer to the mkinitcpio article for more info):

# mkinitcpio -p [name of your kernel preset]

The kernel command line

You now need to set quiet splash as you kernel command line parametres in your bootloader. The following is an example for Grub2 and Template:Filename (the legacy Grub and Lilo follow the same pattern):

linux /boot/vmlinuz26 root=/dev/... ro quiet splash

You can force enable KMS early start by appending "radeon.modeset=1" (for radeon cards) or "i915.modeset=1" (for intel cards) to your kernel options:

linux /boot/vmlinuz26 root=/dev/... radeon.modeset=1
linux /boot/vmlinuz26 root=/dev/... i915.modeset=1

You may also edit the file Template:Filename and append your kernel options to the line GRUB_CMDLINE_LINUX_DEFAULT="". To re-generate Template:Filename run:

# grub-mkconfig -o /boot/grub/grub.cfg

Themes

You can install splashy-themes in AUR to get a nice splashy theme. After installing, look at the available themes like so:

$ ls /usr/share/splashy/themes

The folder name is the theme name. Now edit Template:Filename and change the theme name to the one you want, eg.:

<current_theme>archlinux-simplyblack</current_theme>
Note: Themes ending in 43 are of 4:3 aspect ratio - the others are widescreen.

Rebuild your kernel image with:

# mkinitcpio -p [name of your kernel preset]

and reboot.

Troubleshooting

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: please use the first argument of the template to provide a brief explanation. (Discuss in Talk:Splashy#)
  1. Splashy doesn't terminate or automatically switch to verbose mode if an error occurs or when an init script fails. No longer true with splashy-full package.
  2. Something goes "terribly wrong" when a forced filesystem check commences while Splashy is running. For some unknown reason (yet), the system reboots itself after the fsck.
  3. X can show artefacts on the top of the screen, if splashy is activated during bootup.
  4. Adding <autoverboseonerror>no</autoverboseonerror> in /etc/splashy/config.xml may solve problems when booting in battery mode on laptops
  5. If you get a lot of directfb errors, change "1.2" to "1.4" in /lib/initcpio/install/splashy
  6. If you get an error with libjpeg, try installing libjpeg6
  7. If you use gsplashy and a theme does not appear on the list, make sure that config.xml in the folder of the theme is named theme.xml instead
  8. If you get a libz.so.1 error, try either symlinking /lib/libz.so.1 to /usr/lib/libz.so.1 or changing /lib/libz.so.1 to /usr/libz.so.1 in /lib/initcpio/install/splashy
  9. If you are using Gnome, and are starting GDM as a daemon, Splashy causes Gnome to not be able to properly shutdown/reboot. To fix this issue, remove GDM as a daemon from /etc/rc.conf, and set up GDM with the /etc/inittab file. This could possibly work with other display managers, but I can only confirm that this works with GDM.

Links