How to customize the Omarchy boot logo

The default Omarchy boot logo looks great, but if you’re the kind of person who rices your setup, sooner or later you’ll want to swap it for something personal.

This post covers two ways to do it:

1. The easy way — use Omarchy’s built-in omarchy plymouth command (available on newer Omarchy installs).
2. The manual way — replace the Plymouth theme image directly and regenerate the bootloader.

What you are actually changing

Omarchy uses Plymouth for the boot/unlock splash screen and Limine as the bootloader. The logo you see during boot lives in the Plymouth theme directory. Changing it means updating the theme image and refreshing whatever caches the bootloader needs.

On newer Omarchy versions, the omarchy plymouth command wraps both steps for you.

Option 1: use the built-in Omarchy command

Open a terminal and run:

omarchy plymouth preview

This renders a preview of the boot screen with your current logo and accent colors. If it looks right, apply it:

omarchy plymouth set

To go back to the default Omarchy branding:

omarchy plymouth reset

That’s it. Reboot to see the change.

Option 2: replace the logo manually

If you want full control over the image format or the built-in command isn’t available, do it by hand.

1. Prepare your image

Install ImageMagick if you don’t have it yet:

sudo pacman -S imagemagick

Convert your source image to the format Plymouth expects. Replace $INPUT_FILE with your image path.

magick "$INPUT_FILE" \
  -density "72" \
  -units PixelsPerInch \
  -depth 8 \
  -colorspace sRGB \
  -type PaletteAlpha \
  "logo.png"

If the image has a solid background you want to make transparent, run this first:

magick "$INPUT_FILE" -fuzz 15% -transparent black -trim +repage "$INPUT_FILE"

2. Replace the theme file

Copy your prepared logo.png into the Omarchy Plymouth theme:

sudo cp logo.png /usr/share/plymouth/themes/omarchy/logo.png

You need sudo because /usr/share/plymouth is a system directory.

3. Refresh the bootloader

Run Limine’s update command so the new logo is picked up:

sudo limine-update

4. Reboot

sudo reboot

After reboot you should see your custom logo on the boot/unlock screen.

Troubleshooting

• Preview looks different from boot: Plymouth renders at a different resolution and color depth than your desktop. Preview is approximate; the real test is a reboot.
• Logo is invisible or garbled: Make sure the image is PaletteAlpha, 8-bit depth, and sRGB colorspace. Non-PNG formats or high bit depths often fail silently in Plymouth.
• Change didn’t apply: Run sudo limine-update again and double-check the path is /usr/share/plymouth/themes/omarchy/logo.png (not a similarly-named user directory).
• No omarchy plymouth command: Your Omarchy install may be older than the branding feature. Use the manual path, or update Omarchy first.

Where this lives in the system

Further reading

• Omarchy manual: Branding
• Omarchy on GitHub
• Plymouth theming overview
• Limine documentation