Bootsplash
From wikiPodLinux
| Graphical Startup Screen | |
| |
| Category | Applications |
|---|---|
| Maintainer | Joshua Oreman |
| Last updated | 6 Sep 2005 |
| Version | 1.0 |
| Runs on | 1g, 2g, 3g, 4g, Mini, Photo |
| Requires | an iPod |
| Download | .tgz format |
| Support | IRC (irc://irc.freenode.net/#ipodlinux) |
Bootsplash is a program to show a pretty status display while /etc/rc is running, instead of the quickly scrolling list of commands. Current features:
- Display a user-configurable animated status indicator while running the commands, and a user-definable static image for each group of commands (you decide what constitutes a "group")
- Display a progress bar (% of commands executed so far) at the bottom of the screen.
- On mono iPods, it's just the three bottom-most lines of the screen; on color iPods, it's a nice Aqua-looking progress bar.
- On color iPods (due to their extra screen real estate), display the command currently executing and the name of the current group (e.g. Initializing iPodLinux, Mounting drives, Loading MPD, etc.)
- Gracefully degrades to standard /etc/rc if you mess something up.
- This does not work on new color, nano, or video iPods yet.
[UPDATE]: works on 4g photo and nano 1g ipods just fine
| Table of contents |
Download
Download Media:bootsplash-1.0.tgz and extract it somewhere convenient.
The program is precompiled, since it uses SDL, SDL_image, SDL_gfx, libpng, and zlib, and it's a real pain to get all that together. However, the source is included for the curious.
Should work on Windows as well as Linux/OS X. Thanks, User:Fizzy.
Linux/OS X Installation
Linux users: mount your iPod at e.g. /mnt/ipod. OS X users: your iPod is probably at /Volumes/iPod, replace /mnt/ipod with /Volumes/iPod in the following. Also, If you are using OS X, in iTunes, Enable Disk usage. This way, you can do it in Finder.
Copy the bootsplash program over:
cp bootsplash /mnt/ipod/bin/
Create a folder for the images:
mkdir -p /mnt/ipod/usr/share/bootsplash
Copy the images:
cp default/*.png /mnt/ipod/usr/share/bootsplash
Edit /mnt/ipod/etc/rc as described below.
Unmount your iPod, reboot it, and enjoy the show!
/etc/rc Fixing (Linux/OS X)
Move the following line to the very beginning of the file.
mount -t proc proc /proc
Right after the /proc line, add this:
bootsplash /etc/rc && while true; do podzilla; done
Right before podzilla, add the following to prevent stuff from being displayed at the same time as podzilla.
: STOP
Save the file.
Windows Installation
Okay, here's the long-awaited Windows tutorial. Connect your iPod to your PC using the normal Apple Firmware.
Copy the bootsplash file over to your root of your iPod.
Now copy the "default" folder (contains .png images) to you root of your iPod.
Make a start file (no extension) in the root of your iPod with the following data:
mv /hp/bootsplash /bin/bootsplash mkdir -p /usr/share/bootsplash mv /hp/default/*.png /usr/share/bootsplash rmdir /hp/default cp /etc/rc /hp/rc rm /hp/start
Now disconnect your iPod from your PC accordingly and then boot into iPodLinux. This should execute the start file. Once you're in podzilla reboot your iPod back into the Apple firmware, then connect your iPod to your PC.
Now navigate to your iPod's root and copy the file "rc" to your pc. You need to open this file in your favorite text editor (i.e. Notepad).
Edit rc as described below.
/etc/rc Fixing (Windows)
Move the following line to the very beginning of the file.
mount -t proc proc /proc
Right after the /proc line, add this:
bootsplash /etc/rc && while true; do podzilla; done
Right before podzilla, add the following to prevent stuff from being displayed at the same time as podzilla.
: STOP
Before we continue, navigate below to the Groups information. Follow those steps accordingly to finish adding your group/icons, then continue from here...
Save the file and put it back to the root of your iPod.
Make another start file with the following code:
mv /hp/rc /etc/rc rm /hp/start
Now disconnect your iPod accordingly and boot into iPodLinux (you won't yet see the boot image(s) until you do yet another boot into iPodLinux). This time once your reach podzilla you can say to yourself I've done it!.
So far everything has been setup correctly and the rc file has been updated.
As of now every time you boot your iPod into iPodLinux be amazed. Go on try it right know! This time you will see it ;)
Windows tutorial by DoN FiZzY
Various corrections made by Josh.
Groups
Bootsplash considers your rc file as one or more "groups" of commands. Each group has associated with it an icon and a description (the latter is displayed on color iPods only).
Before you define a group, the icon will not be displayed and the description will be blank.
To start a group, put a line in /etc/rc:
: icon Description
where icon is the basename of the 64x64 icon to display, and Description is a short description that may include spaces (e.g. Initializing iPodLinux...).
The included group icons are "ipl", "net", "hd", "music", and "done" (not including the quotes). Use as you see fit.
Image Naming
- All images go in /usr/share/bootsplash, and all are PNGs.
- The status indicator images are status.1.png through status.N.png on monochrome iPods, and status-c.1.png through status-c.N.png on color iPods. They will be played at about 5-10 fps, looping.
- The image for a group
groupnameis called groupname.png on a mono iPod, and groupname-c.png on a color. - On color iPods, you additionally need two files
progbar-e.pngandprogbar-f.png, which have pictures of the "empty" and "full" progress bar, respectively. It must be at least 160 pixels wide. - If you're missing the status or progress bar images, bootsplash won't run. If you're missing a group image, that group image won't show up and you'll get an error (that you'll probably never see) on stderr.
Authors
Enjoy. Josh 21:47, 6 Sep 2005 (CDT)
Thanks to DoN FiZzY for the Windows tutorial: 00:14, 14 Sep 2005 (GMT)
