Improved clarity of README, added section on custom wallpapers and reformatted most of it

This commit is contained in:
Stuart Hayhurst 2020-10-16 17:40:48 +01:00
parent 4aa0e8034a
commit bc8747f286
2 changed files with 44 additions and 54 deletions

View file

@ -7,66 +7,69 @@
```
## Flat Design themes for Grub2.
## Flat Design themes for Grub
**If you want to use Custom Wallpapers read the "Add_Custom_Wallpaper" file in the backgrounds folder**
## Install
## Installation:
Usage: `sudo ./install.sh [OPTIONS...]`
_if no option used the terminal user interface will be show up_
| OPTIONS: | description |
|:-------------------|:-------------|
| -b, --boot | Install grub theme into /boot/grub/themes |
| -v, --vimix | Vimix grub theme |
| -s, --stylish | Stylish grub theme |
| -t, --tela | Tela grub theme |
| -l, --slaze | Slaze grub theme |
| -w, --white | Install white color icon version |
| -u, --ultrawide | Install 2560x1080 background image - not available for slaze theme|
| 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|
| -2, --2k | Install 2k (2560x1440) background image |
| -4, --4k | Install 4k (3840x2160) background image |
| -r, --remove | Remove theme (must add theme name option) |
| -r, --remove [THEME]| Uninstall selected theme |
| -h, --help | Show this help |
For example:
_If no options are used, a user interface will show up instead_
1. Install Tela theme on 2k display device
### Examples:
- Install Tela theme on 2k display device:
- `sudo ./install.sh --tela --2k`
`sudo ./install.sh -t -2`
or
`sudo ./install.sh --tela --2k`
- Install Tela theme into /boot/grub/themes:
- `sudo ./install.sh -b -t`
2. Install Tela theme into /boot/grub/themes
- Uninstall Tela theme:
- `sudo ./install.sh -r -t`
`sudo ./install.sh -b -t`
## Issues / tweaks:
3. Remove Tela theme
### Correcting display resolution:
`sudo ./install.sh -r -t`
- On the grub screen, precc `c` to enter the command line
- Enter `vbeinfo` or `videoinfo` to check available resolutions
- Open `/etc/default/grub`, and edit `GRUB_GFXMODE=[height]x[width]x32` to match your resolution
- Finally, run `grub-mkconfig -o /boot/grub/grub.cfg` to update your grub config
## Display resolution issues
### Setting a custom background:
#### Set the right resolution of your display
- Find the resolution of your display (1920x1080 -> 1080p, 2560x1080 -> 1080p_21:9, 2560x1440 -> 2k, 3840x2160 -> 4k)
- Place your custom background inside the correct folder matching your resolution, and make sure it's a .jpg
- Rename the default wallpaper for your chosen theme to something else
- Rename the custom wallpaper to the name of the default wallpaper for your chosen theme
- Run the installer like normal, making sure to select your chosen theme
On the grub screen, `press c` to get the commandline, and enter `vbeinfo` or `videoinfo` on EFI boot to check what resolutions you can use, then edit `/etc/default/grub` , add your resolution `GRUB_GFXMODE=****x****x32` into it, last you can run `grub-mkconfig -o /boot/grub/grub.cfg` to update your grub.cfg.
## Screenshots:
## Screenshots
### Vimix grub theme:
### Vimix grub theme
![Vimix](screenshots/grub-theme-vimix.jpg?raw=true)
![vimix grub theme](screenshots/grub-theme-vimix.jpg?raw=true)
### Stylish grub theme:
### Stylish grub theme
![Stylish](screenshots/grub-theme-stylish.jpg?raw=true)
![Stylish grub theme](screenshots/grub-theme-stylish.jpg?raw=true)
### Tela grub theme:
### Tela grub theme
![Tela](screenshots/grub-theme-tela.jpg?raw=true)
![Tela grub theme](screenshots/grub-theme-tela.jpg?raw=true)
### Slaze grub theme:
### Slaze grub theme
![Slaze grub theme](screenshots/grub-theme-slaze.jpg?raw=true)
![Slaze](screenshots/grub-theme-slaze.jpg?raw=true)

View file

@ -1,13 +0,0 @@
## To Add Custom Wallpapers in Grub themes present ##
Easiest Method (Other Method is to change the install script but that will waste your time)
1. First thing is knowing your screen resolution if it is 1920x1080 then go into the folder 1080p.
2. Paste your desired photo inside the folder (in the above example inside 1080p) and make sure it is a jpg file.
3. Let's say now if you want to use Vimix theme, then rename the default wallpaper for that theme to something else (in this case for eg. 1.jpg).
4. Now rename your desired image to the same name as the default wallpaper for that theme was (in our case "background-vimix").
---------------------------------------------------------------------------------x-----------------------------------------------------------------------------------