01. Overview & Architecture

Profile: v1.0.0
Purpose
Catppuccin theme for the GRUB bootloader.
Compatibility
Any distro (Server: BOTH)
Window Manager & Theme
Any WM / DE / Catppuccin
Full Description
Catppuccin theme for the GRUB bootloader.

02. Installation & Deployment

Method: Verified Command

Step-by-step deployment protocol

Step-by-step deployment
1Clone the theme
$git clone --depth 1 https://github.com/catppuccin/grub && cd grub
2Copy a flavor and point GRUB at it
$sudo cp -r src/catppuccin-mocha-grub-theme /usr/share/grub/themes/
$# /etc/default/grub: GRUB_THEME="/usr/share/grub/themes/catppuccin-mocha-grub-theme/theme.txt"
3Regenerate the GRUB config
$sudo grub-mkconfig -o /boot/grub/grub.cfg

03. Screenshot Gallery // Catppuccin GRUB

Capture 01 // Fullscreen
Catppuccin GRUB screenshot 1
01 / 08

04. Documentation & Guide

Source: catppuccin/grubRef: 0a37ab19f6
README.md|GitHub Flavored Markdown

Logo
Catppuccin for Grub

Stargazers

Previews

🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha

Usage

  1. Clone this repository locally and enter the cloned folder:

    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:

    sudo cp -r src/* /usr/share/grub/themes/
    
  3. 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"
    
  4. 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

GitHub Flavored Markdown (github-markdown-css)● Live Repo Synced