https://github.com/catppuccin/grub
🌕 Soothing pastel theme for Grub2 & Ventoy
https://github.com/catppuccin/grub
bootloader-theme catppuccin fancy grub-theme grub2 hacktoberfest linux pastel-colors
Last synced: 2 months ago
JSON representation
🌕 Soothing pastel theme for Grub2 & Ventoy
- Host: GitHub
- URL: https://github.com/catppuccin/grub
- Owner: catppuccin
- License: mit
- Created: 2022-02-01T17:01:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-11T08:57:20.000Z (3 months ago)
- Last Synced: 2025-07-11T11:51:44.788Z (3 months ago)
- Topics: bootloader-theme, catppuccin, fancy, grub-theme, grub2, hacktoberfest, linux, pastel-colors
- Homepage:
- Size: 7.85 MB
- Stars: 459
- Watchers: 6
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Catppuccin for Grub
## Previews
🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha
## Usage
1. Clone this repository locally and enter the cloned folder:
```shell
git clone https://github.com/catppuccin/grub.git && cd grub
```
2. Copy all or selected theme from `src` folder to
`/usr/share/grub/themes/`. E.g. to copy all themes use:
```shell
sudo cp -r src/* /usr/share/grub/themes/
```
3. Uncomment and edit following line in `/etc/default/grub` to your selected
theme:
```shell
GRUB_THEME="/usr/share/grub/themes/catppuccin--grub-theme/theme.txt"
```
4. Update grub:
```shell
sudo grub-mkconfig -o /boot/grub/grub.cfg
```
For Fedora:
```shell
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
```
## 💿 Ventoy Support
See instructions in the [ventoy directory](ventoy/).
## 🙋 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):
```shell
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` :
```shell
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:
```shell
# 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
- [Dooez](https://github.com/Dooez/ventoy-catppuccin)
- [vinceliuice](https://github.com/vinceliuice/grub2-themes)
- [tuhanayim](https://github.com/tuhanayim)
Copyright © 2021-present Catppuccin Org
