thang1191/mikuplymouth

Plymouth is the program that shows an animation on your screen while a Linux system is starting up, before the desktop or login screen appears. This repository provides a Plymouth theme that plays animated clips of Hatsune Miku, a virtual music character, during boot. The clips rotate so you see a different animation each time you start your computer. The theme draws from a pool of 37 short animation clips. Because playing all 37 at once would use too much memory during startup, the installer picks 10 random clips from the pool each time you run it. Those 10 clips are then shuffled into a different order at every boot. If you want the full pool to cycle through over time, you can set up an automatic daily rotation using a standard Linux scheduling tool called systemd, which re-runs the installer once per day shortly after boot. Installation is done by running a shell script with administrator permissions. The README warns that loading too many clips can cause the screen to go blank during startup on lower-end machines, and suggests reducing the clip count if that happens. Customization options include deleting clips you dislike from the pool folder, specifying exactly which clips you want by ID, or raising the count if your machine has enough memory to handle more frames loading at once. For users running NixOS, a separate installation path is provided through the NixOS module system, with options for the standard 10-clip package, a full 37-clip package, or a custom list of specific clip numbers. The animations were originally created by an artist credited in the README.