xylidine/custom-video-boot-splash-screen-plymouth-arch-cachyos-guide

This repository is a step by step guide, not a piece of software you install and run. It shows Linux users on Arch or CachyOS how to turn a short video clip into an animated boot splash screen, which is the image or animation your computer shows while it starts up, using a system called Plymouth. The guide walks you through converting your video into a sequence of still images at your screen's exact native resolution, since the boot screen displays images one after another rather than actually playing a video file. It explains how to extract those images from your video using ffmpeg, a common command line video tool, at a frame rate that keeps the animation smooth without making the file too large. Rather than making you build a boot theme from scratch, the repo includes a ready made theme folder called nazuna boot v2, already set up with the correct settings, so you only need to drop your own images into it. From there, the guide covers copying that theme into the right system folder, telling the system's initramfs builder to include every file in the theme, since this step is easy to get wrong and silently break things, and then rebuilding the boot image and setting the new theme as default. The guide also includes a solid troubleshooting section covering common problems, like a black screen appearing when testing inside a desktop session instead of a real terminal, or the system quietly falling back to its default grey dots animation when something in the custom theme fails to load, along with how to turn on debug logging to see the real cause. This is aimed at Linux users comfortable with the command line who want to personalize how their machine looks while booting, and it explains why it uses Plymouth's built in two step animation engine instead of writing custom scripts, since that engine is simpler and more reliable.