Splash logo

Post Reply
apollolt1
Posts: 1
Joined: Wed Feb 18, 2026 2:50 am

Splash logo

Post by apollolt1 »

How do I replace the Hudiy boot splash image with a custom logo. i want to use a Custom GMC logo so it matches my truck
hudiy
Site Admin
Posts: 659
Joined: Mon Jul 14, 2025 7:42 pm

Re: Splash logo

Post by hudiy »

The splash program is responsible for showing the logo when Hudiy starts. Using the --logo command-line argument you can set the path to your own logo.

On our GitHub you can find more details about the splash program: https://github.com/wiboma/hudiy/blob/ma ... .md#splash
Hudiy Team
TheTHM
Posts: 3
Joined: Wed Sep 02, 2026 6:43 pm

Re: Splash logo

Post by TheTHM »

hudiy wrote: Wed Feb 18, 2026 1:16 pm The splash program is responsible for showing the logo when Hudiy starts. Using the --logo command-line argument you can set the path to your own logo.

On our GitHub you can find more details about the splash program: https://github.com/wiboma/hudiy/blob/ma ... .md#splash
Can you please provide an example of this "--logo" command being used? The information on the github isn't exactly helpful, as it just states a general usage.
hudiy
Site Admin
Posts: 659
Joined: Mon Jul 14, 2025 7:42 pm

Re: Splash logo

Post by hudiy »

TheTHM wrote: Wed Sep 02, 2026 6:47 pm
hudiy wrote: Wed Feb 18, 2026 1:16 pm The splash program is responsible for showing the logo when Hudiy starts. Using the --logo command-line argument you can set the path to your own logo.

On our GitHub you can find more details about the splash program: https://github.com/wiboma/hudiy/blob/ma ... .md#splash
Can you please provide an example of this "--logo" command being used? The information on the github isn't exactly helpful, as it just states a general usage.
--logo is a command-line argument for the splash application that launches Hudiy. The splash application is executed from $HOME/.hudiy/share/hudiy_run.sh via line:

Code: Select all

$HOME/.hudiy/share/splash $HOME/.hudiy/share/hudiy_startup.sh
You can add --logo to this line and provide the path to your logo or GIF animation file, for example:

Code: Select all

$HOME/.hudiy/share/splash --logo /home/pi/Pictures/logo.png $HOME/.hudiy/share/hudiy_startup.sh
On Raspberry Pi, the splash application is run only in Desktop mode (the default mode for Raspberry Pi 4 and 5): https://github.com/wiboma/hudiy/blob/ma ... vs-console
Hudiy Team
TheTHM
Posts: 3
Joined: Wed Sep 02, 2026 6:43 pm

Re: Splash logo

Post by TheTHM »

Thank you for your fast response.

This is what I'm seeing when I run this command.
"qt.qpa.xcb: could not connect to display
qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: wayland, eglfs, minimal, offscreen, minimalegl, xcb, linuxfb, vkkhrdisplay, wayland-egl.

Aborted"

Any ideas on how to fix this? I'm feeling like an idiot, haha! I am running this on a Pi5. Tried to run the command on the Pi desktop without any luck as well.

***Update***
Looks like it just took trying it about 10 times! Thanks for your help with this.
Last edited by TheTHM on Wed Sep 02, 2026 8:54 pm, edited 1 time in total.
hudiy
Site Admin
Posts: 659
Joined: Mon Jul 14, 2025 7:42 pm

Re: Splash logo

Post by hudiy »

This command should not be run standalone. If you want to run Hudiy manually, use the command $HOME/.hudiy/share/hudiy_run.sh (and add --logo there to $HOME/.hudiy/share/splash $HOME/.hudiy/share/hudiy_startup.sh line)

To run Hudiy via SSH, you must export XDG_RUNTIME_DIR and WAYLAND_DISPLAY before execution.

Code: Select all

export XDG_RUNTIME_DIR="/run/user/$(id -u)"
export WAYLAND_DISPLAY=wayland-0
$HOME/.hudiy/share/hudiy_run.sh
Hudiy Team
TheTHM
Posts: 3
Joined: Wed Sep 02, 2026 6:43 pm

Re: Splash logo

Post by TheTHM »

So, to spell it out for idiots like myself...

Add the --logo command to line 8 of hudiy_run.sh

**EXAMPLE**
--------------------------------------
#!/bin/bash

source "$HOME/.hudiy/share/rpi_lib.sh"

export LD_LIBRARY_PATH=$HOME/.hudiy/share/:$LD_LIBRARY_PATH

if [[ "$CURRENT_TARGET" == "$TARGET_GUI" ]]; then
$HOME/.hudiy/share/splash --logo /home/USERNAME/Pictures/YOUR_LOGO.jpg $HOME/.hudiy/share/hudiy_startup.sh
else
export QT_QPA_PLATFORM=eglfs
export QT_QPA_EVDEV_KEYBOARD_PARAMETERS=grab=1
export QT_QPA_EGLFS_NO_LIBINPUT=1

if [[ "$CURRENT_MODEL" == *"$PI5_MODEL"* ]] || [[ "$CURRENT_MODEL" == *"$CM5_MODEL"* ]]; then
export QT_QPA_EGLFS_KMS_CONFIG=$HOME/.hudiy/share/eglfs_pi5.json
fi

$HOME/.hudiy/share/hudiy_startup.sh
fi
Post Reply