Customizing the Boot Animation¶
The Famoco devices support boot animation customization. Follow the steps below to personalize your devices.
How to create your boot animation¶
1. Determine your device's resolution¶
You can find this information in the specifications accessible from this page.
2. Create the basic structure¶
- Create a new directory called bootanimation
- In that directory, create an empty file called desc.txt
- If your bootanimation has several sequences :
- Create one directory per sequence of your animation. You can call them partX with X being a number (part0, part1…)
- The first part should be part0
3. Prepare the pictures¶
They should be formatted as PNG.
Place your files in the corresponding sequence directories (partX), in their correct order:
- 00.PNG
- 01.PNG
- 02.PNG
- ...
Make sure there are no hidden files, like .DS_Store files for instance, in the directories. Android would try to load them as images, breaking the whole animation.
4. Fill the desc.txt with the following information¶
File format:
[device_screen_px_width] [device_screen_px_height] [frame_per_second]
p [sequence_repetitions] [delay_between_repetitions] [sequence_directory]
{p [sequence_repetitions] [delay_between_repetitions] [sequence_directory]}
Description:
- p : defines a sequence which will be read
- device_screen_px_width : width of the device's screen
- device_screen_px_height : height of the device's screen
- frame_per_second : speed of the bootanimation / number of pictures contained in the folder of the related sequence which will be read per second
- sequence_repetitions : the amount of times that we want the related sequence to be read. 0 (zero) would mean infinitely, until the device's boot ends.
- delay_between_repetitions : time to wait between each repetition of the related sequence. It is expressed in the number of frames, which can be translated into time by dividing it by the frame rate.
- sequence_directory : the folder which contains the pictures for the related sequence
Example:
320 480 10
p 1 1 part0
p 2 3 part1
p 0 0 part2
Example meaning:
- This example represents a bootanimation which will be launched on a device with a screen resolution of 320x480.
- It will be played at the speed of 10 pictures per second
- The first sequence of pictures, contained in the folder part0, will be played 1 time
- The second sequence of pictures, contained in the folder part1, will be played 2 times
- The third sequence of pictures, contained in the folder part2, will be played infinitely until the device's boot ends, without any pause between each reading
Recommendation : At the end of the file, you should put an empty new line.
5. Create a non-compressed zip archive (STORE mode) of the bootimage directory¶
With the command line under Linux or Mac OS : zip -r -0 ./bootanimation.zip * (being in the bootanimation folder).
6. Deploy and test your bootanimation¶
- With the MDM (recommended way):
- Add the bootanimation.zip file in the desired profile
- Sync a device linked to that profile
- Reboot the device
- With ADB (developer mode only):
- To install your boot animation:
adb push bootanimation.zip /cache/famoco/media - To play your boot animation:
adb reboot
- To install your boot animation: