____ ____ _ _ ____ ____ _____ _ _ _____ __ __ _____ ____
/ ___| _ \| | | | __ )___ \ |_ _| | | | ____| \/ | ____/ ___|
| | _| |_) | | | | _ \ __) | | | | |_| | _| | |\/| | _| \___ \
| |_| | _ <| |_| | |_) / __/ | | | _ | |___| | | | |___ ___) |
\____|_| \_\\___/|____/_____| |_| |_| |_|_____|_| |_|_____|____/
Usage: sudo ./install.sh [OPTIONS...]
Options: | Description: |
---|---|
-b, --boot | Install grub theme into /boot/grub/themes |
-v, --vimix | Install Vimix grub theme |
-s, --stylish | Install Stylish grub theme |
-t, --tela | Install Tela grub theme |
-l, --slaze | Install Slaze grub theme |
-w, --white | Install using black and white icons |
-u, --ultrawide | Install 21:9 (2560x1080) background image - not available for slaze theme |
-C, --custom-background | Use either background.jpg or custom-background.jpg as theme background instead |
-2, --2k | Install 2k (2560x1440) background image |
-4, --4k | Install 4k (3840x2160) background image |
-r, --remove [THEME] | Uninstall selected theme |
-h, --help | Show this help |
If no options are used, a user interface will show up instead
-
Install Tela theme on 2k display device:
sudo ./install.sh --tela --2k
-
Install Tela theme into /boot/grub/themes:
sudo ./install.sh -b -t
-
Uninstall Tela theme:
sudo ./install.sh -r -t
- On the grub screen, press
c
to enter the command line - Enter
vbeinfo
orvideoinfo
to check available resolutions - Open
/etc/default/grub
, and editGRUB_GFXMODE=[height]x[width]x32
to match your resolution - Finally, run
grub-mkconfig -o /boot/grub/grub.cfg
to update your grub config
- Make sure you have
imagemagick
installed, or at least something that providesconvert
- Find the resolution of your display, and make sure your background matches the resolution
- (1920x1080 -> --1080p, 2560x1080 -> --ultrawide, 2560x1440 -> --2k, 3840x2160 -> --4k)
- Place your custom background inside the root of the project, and name it either background.jpg or custom-background.jpg
- Run the installer like normal, but with
--custom-background
,--[YOUR_RESOLUTION]
and--[THEME]
- Make sure to replace
[YOUR_RESOLUTION]
with your resolution and[THEME]
with the theme
- Make sure to replace
- If you made changes to icons, or added a new one:
- Delete the existing icon, if there is one
- Run
cd assets; ./render-all.sh
- Create a pull request from your branch or fork
- If any issues occur, report then to the issue page