Hi, I’m the Toradex AI Assistant.
I might make mistakes or occasionally get you wrong. Our support team will step in if needed.
Based on your Torizon OS 7.4.0 on Colibri iMX7D, I can guide you through the proper splash screen setup. Since you mentioned the OSTree-based approach didn’t work, I recommend using TorizonCore Builder, which is the recommended method for production environments(1).
Prerequisites
Before we begin, ensure you have(2):
- A custom splash screen image in PNG format with maximum resolution of your screen (-32 pixels in height for the waiting animation)(2)
- TorizonCore Builder installed(1)
- A Torizon OS base image downloaded(1)
Method 1: Using TorizonCore Builder Build Command (Recommended)
This approach uses a YAML configuration file and is recommended for production(1).
Step 1: Create Configuration File
Create a tcbuild.yaml file with your splash screen configuration(1):
# Sample configuration file:
input:
easy-installer:
local: images/torizon-core-docker-colibri-imx7-Tezi_7.4.0+build.28.tar
#Sample customization: insert a Splash Screen
customization:
# >> Splash screen:
splash-screen: splash.png
output:
easy-installer:
local: torizon-core-docker-colibri-imx7-Tezi_7.4.0.CUSTOM
(1)
Step 2: Prepare Your Splash Image
Ensure your splash.png file is in the same directory as the tcbuild.yaml file(1). You can download an example image from the documentation if needed(1).
Step 3: Build the Custom Image
Run the build command in the directory containing your tcbuild.yaml(1):
$ torizoncore-builder build
(1)
Step 4: Deploy the Image
You can deploy using Toradex Easy Installer by copying the output to a USB stick(1):
$ cp -a torizon-core-docker-colibri-imx7-Tezi_7.4.0.CUSTOM /media/user/myUSBstick
(1)
Method 2: Using Standalone Commands
If you prefer incremental changes, use the standalone approach(1):
Step 1: Unpack Base Image
$ torizoncore-builder images unpack torizon-core-docker-colibri-imx7-Tezi_7.4.0+build.28.tar
(1)
Step 2: Apply Splash Screen
$ torizoncore-builder splash splash.png
(3)
Step 3: Merge Changes
$ torizoncore-builder union custom-branch
(1)
Step 4: Deploy
$ torizoncore-builder deploy --remote-host <your_device_ip> --remote-username torizon --remote-password <your_password> custom-branch
(1)
Important Notes
- The deprecated
ostree-customize-plymouth.sh script is still available in Torizon OS 7 but should not be used for new implementations(4)(2)
- TorizonCore Builder is the recommended method for development and production(2)(1)
- Your splash screen will be managed by Plymouth, which starts very early during boot from the initramfs(2)
Troubleshooting
If you encounter issues:
- Verify your PNG image meets the size requirements
- Ensure TorizonCore Builder version is 3.15.0 or later for splash configuration features(1)
- Check that your base image path is correct in the configuration
This approach should work reliably with your Colibri iMX7D setup running Torizon OS 7.4.0.
Best regards, Toradex AI Assistant.
Did you like my answer? 
If I answered your question, please tick the “Solution” checkbox.
For follow-up questions to me, please use @ToradexAI in your post.
