Boot Image Modification

This page is used to modify the boot logo, home screen image, and printing interface image of the Fly-WiScreen 5-inch screen. This operation only replaces the WiScreen 5 screen resource images and does not modify Klipper, FlyOS-FAST, or the screen firmware.

Scope of Application

• Fly-WiScreen 5-inch screen: Place the image in the root directory of an SD card or USB drive and click Upgrade on the screen following the methods on this page.
• FLY Screen: Upload via browser to the system configuration directory for automatic replacement; the SD card/USB upgrade method on this page is not used. The current FlyScreen project does not include boot_logo.JPG boot logo replacement.

File Requirements

• Image resolution, format, filename, and size must fully meet the requirements.
• Filenames are case-sensitive; the .JPG in boot_logo.JPG must be uppercase.
• Do not place images inside folders; place them directly in the root directory of the SD card or USB drive.

Image Specifications

Image Usage	Resolution	Format	Filename	Size Limit
Boot Logo	800 x 480	JPG	Loading...	No more than 105 KB
Home Screen Image	500 x 400	PNG	Loading...	No more than 45 KB
Printing Interface Image	311 x 480	PNG	Loading...	No more than 45 KB

Windows File Extension Display

Windows may hide file extensions by default, which can easily result in files being saved as boot_logo.JPG.jpg or print.png.png. Before creating images, enable extension display in File Explorer:

1. Open any folder.
2. Click View at the top.
3. Check File name extensions.
4. When renaming files, ensure the full filename matches the table above exactly.

Preparing Files

1. Create images according to the dimensions in the table above.
2. Confirm the filenames match the table above exactly.
3. Copy the images to be updated to the root directory of an SD card or USB drive.
4. Safely eject the SD card or USB drive to ensure files are fully written.

Upgrade Steps

1. Ensure the WiScreen 5 has booted normally and entered the screen interface.
2. Insert the prepared SD card or USB drive into the corresponding port on the screen.
3. Click Upgrade on the screen interface.
4. Wait for the screen to indicate that the upgrade is complete or for it to refresh automatically.
5. Remove the SD card or USB drive, then restart the screen to confirm if the images have taken effect.

Upgrade Process

Do not power off or remove the SD card or USB drive during the upgrade process. If the upgrade is interrupted, image resources may not be fully written, requiring you to re-prepare the files and perform the upgrade again.

Result Verification

Phenomenon	Judgment
Boot logo changed after restart	boot_logo.JPG updated successfully
Home screen image changed	print.png updated successfully
Printing interface image changed	print_smail.png updated successfully
No change after clicking upgrade	First check the filename, format, size, and root directory location

Common Issues

Screen does not recognize the image

1. Verify the image is in the root directory of the SD card or USB drive.
2. Verify the filename has no extra extensions, e.g., do not write boot_logo.JPG.jpg.
3. Verify the extension of boot_logo.JPG is uppercase .JPG.
4. Verify the file size does not exceed the limit.

Image appears distorted or cropped

Please re-export the image at the specified resolution; do not simply rename an image with a different aspect ratio.

Old image still displayed after clicking upgrade

1. Reformat the SD card or USB drive before copying the image again.
2. Keep only the image files needed for this update to avoid mixing in old files.
3. Reinsert the screen and click Upgrade again.
4. If it still fails, try a different SD card or USB drive.

Differences from FLY Screen

The Fly-WiScreen 5 serial screen uses moon2uart for communication and does not use the fly_screen switch. fly_screen is the FlyOS-FAST local screen display service, applicable to local display scenarios such as FLY-TFT and HDMI.

The image replacement methods differ between the two; boot_logo.JPG is only applicable to the Fly-WiScreen 5-inch screen.

Feature	Replacement Method
Fly-WiScreen 5-inch screen	Place the image in the root directory of an SD card or USB drive, click Upgrade on the screen
FLY Screen	Access the system configuration file management interface via browser, upload print.png or print_smail.png for automatic replacement

FLY Screen Image Replacement: FLY Screen Image Replacement