elie/grub2-themes
1
0
Fork 0
mirror of https://github.com/vinceliuice/grub2-themes.git synced 2024-12-25 20:15:35 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #88 from Dragon8oy/readme-update

Browse Source 
Rewrite README
This commit is contained in:
Vince 2020-10-17 19:34:23 +08:00 committed by GitHub
commit 6b15522416
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 51 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

89
README.md
View File

@ -7,66 +7,77 @@
``` ```
## 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** ## Installation:
## Install
Usage: `sudo ./install.sh [OPTIONS...]` Usage: `sudo ./install.sh [OPTIONS...]`
_if no option used the terminal user interface will be show up_ | Options: | Description: |
|:-----------------------|:-------------|
| OPTIONS: | description | | -b, --boot | Install grub theme into `/boot/grub/themes` |
|:-------------------|:-------------| | -v, --vimix | Install Vimix grub theme |
| -b, --boot | Install grub theme into /boot/grub/themes | | -s, --stylish | Install Stylish grub theme |
| -v, --vimix | Vimix grub theme | | -t, --tela | Install Tela grub theme |
| -s, --stylish | Stylish grub theme | | -l, --slaze | Install Slaze grub theme |
| -t, --tela | Tela grub theme | | -w, --white | Install using black and white icons |
| -l, --slaze | Slaze grub theme | | -u, --ultrawide | Install 21:9 (2560x1080) background image - not available for slaze theme|
| -w, --white | Install white color icon version | | -C, --custom-background| Use either background.jpg or custom-background.jpg as theme background instead
| -u, --ultrawide | Install 2560x1080 background image - not available for slaze theme| | -2, --2k | Install 2k (2560x1440) background image |
| -2, --2k | Install 2k(2560x1440) background image | | -4, --4k | Install 4k (3840x2160) background image |
| -4, --4k | Install 4k(3840x2160) background image | | -r, --remove [THEME] | Uninstall selected theme |
| -r, --remove | Remove theme (must add theme name option) |
| -h, --help | Show this help | | -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` - Install Tela theme into /boot/grub/themes:
or - `sudo ./install.sh -b -t`
`sudo ./install.sh --tela --2k`
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, press `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, 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
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. ## Contributing:
- 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](https://github.com/vinceliuice/grub2-themes/issues) page
## Screenshots ## Screenshots:
### Vimix grub theme ### Vimix grub theme:
![vimix grub theme](screenshots/grub-theme-vimix.jpg?raw=true) ![Vimix](screenshots/grub-theme-vimix.jpg?raw=true)
### Stylish grub theme ### Stylish grub theme:
![Stylish grub theme](screenshots/grub-theme-stylish.jpg?raw=true) ![Stylish](screenshots/grub-theme-stylish.jpg?raw=true)
### Tela grub theme ### Tela grub theme:
![Tela grub theme](screenshots/grub-theme-tela.jpg?raw=true) ![Tela](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)

13
backgrounds/Add_Custom_Wallpaper
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-----------------------------------------------------------------------------------