Catppuccin for grub

View on GitHub

Previews

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/, for example to copy all themes use:

    sudo cp -r src/* /usr/share/grub/themes/
    
  3. Uncomment and edit following line in /etc/default/grub to selected theme:

    • 🌻 Catppuccin-latte:

      GRUB_THEME="/usr/share/grub/themes/catppuccin-latte-grub-theme/theme.txt"
      
    • 🪴 Catppuccin-frappe:

      GRUB_THEME="/usr/share/grub/themes/catppuccin-frappe-grub-theme/theme.txt"
      
    • 🌺 Catppuccin-macchiato:

      GRUB_THEME="/usr/share/grub/themes/catppuccin-macchiato-grub-theme/theme.txt"
      
    • 🌿 Catppuccin-mocha:

      GRUB_THEME="/usr/share/grub/themes/catppuccin-mocha-grub-theme/theme.txt"
      
  4. Update grub:

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

🙋 FAQ

  • Q1: "My Grub is not working in my screen resolution"

    A:

    • Uncomment and edit following line in /etc/default/grub (modify 1920x1080 to Your screen resolution):

      GRUB_GFXMODE=1920x1080
      
    • update grub (see point 4)

  • Q2: "My Grub is not detecting my all 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 point 4)

  • Q3: "Grub isn't detecting the theme"

    A1:

    • Make sure to comment the following line in /etc/default/grub:

      GRUB_TERMINAL_OUTPUT="console"
      
    • Save that file and update grub (see point 4)

    A2:

    • If A1 is not working try to replace /usr/share/ with /boot/ and repeat points (2-4)

💝 Thanks to