README.md

September 14, 2024 · View on GitHub

Catppuccin for Grub

Previews

🌻 Latte

🪴 Frappé

🌺 Macchiato

🌿 Mocha

Usage

Clone this repository locally and enter the cloned folder:

git clone https://github.com/catppuccin/grub.git && cd grub

Copy all or selected theme from src folder to /usr/share/grub/themes/. E.g. to copy all themes use:
```
sudo cp -r src/* /usr/share/grub/themes/
```

Uncomment and edit following line in /etc/default/grub to your selected theme:

GRUB_THEME="/usr/share/grub/themes/catppuccin-<flavor>-grub-theme/theme.txt"

Update grub:

sudo grub-mkconfig -o /boot/grub/grub.cfg

For Fedora:

sudo grub2-mkconfig -o /boot/grub2/grub.cfg

💿 Ventoy Support

See instructions in the ventoy directory.

🙋 FAQ

Q: "How can I make Grub work with my screen resolution?"

A: Uncomment and edit following line in /etc/default/grub (modify 1920x1080 to your screen resolution):
```
GRUB_GFXMODE=1920x1080
```
Proceed to update grub (see step 4 of the installation)
Q: "How can I make Grub detect all my operating systems? (dual-boot)"

A: Make sure you have os-prober installed. Add or uncomment following line in /etc/default/grub :
```
GRUB_DISABLE_OS_PROBER=false
```
Save that file and update grub (see step 4 of the installation)
Q: "How can I make Grub detect my theme?"

A: Make sure to comment the following line in /etc/default/grub like so:
```
# GRUB_TERMINAL_OUTPUT="console"
```
Save that file and update grub (step 4). If this did not work, try to replace /usr/share/ with /boot/ and repeat installation steps 2-4.

💝 Thanks to

Copyright © 2021-present Catppuccin Org