2020-10-16 18:40:48 +02:00
|
|
|
## Installation:
|
2019-06-08 04:49:28 +02:00
|
|
|
|
2020-01-25 16:13:33 +01:00
|
|
|
Usage: `sudo ./install.sh [OPTIONS...]`
|
2019-06-08 04:49:28 +02:00
|
|
|
|
2020-10-16 22:59:12 +02:00
|
|
|
| Options: | Description: |
|
|
|
|
|
|:-----------------------|:-------------|
|
|
|
|
|
| -b, --boot | Install grub theme into `/boot/grub/themes` |
|
2021-01-25 17:01:12 +01:00
|
|
|
| -t, --theme | theme variant(s) [tela/vimix/stylish/slaze/whitesur] (default is tela)"
|
|
|
|
|
| -i, --icon | icon variant(s) [color/white/whitesur] (default is color)"
|
|
|
|
|
| -s, --screen | screen resolution variant(s) [1080p/2k/4k/ultrawide/ultrawide2k] (default is 1080p)"
|
2020-10-16 22:59:12 +02:00
|
|
|
| -r, --remove [THEME] | Uninstall selected theme |
|
|
|
|
|
| -h, --help | Show this help |
|
2019-10-01 08:59:14 +02:00
|
|
|
|
2021-01-25 17:01:12 +01:00
|
|
|
_If no options are used, a user interface `dialog` will show up instead_
|
2019-10-25 11:52:53 +02:00
|
|
|
|
2020-10-16 18:40:48 +02:00
|
|
|
### Examples:
|
2020-10-17 12:12:09 +02:00
|
|
|
- Install Tela theme on 2k display device:
|
2021-01-25 17:01:12 +01:00
|
|
|
- `sudo ./install.sh -t tela -s 2k`
|
2019-10-25 11:52:53 +02:00
|
|
|
|
2020-10-17 12:12:09 +02:00
|
|
|
- Install Tela theme into /boot/grub/themes:
|
2021-01-25 17:01:12 +01:00
|
|
|
- `sudo ./install.sh -b -t tela`
|
2020-03-30 06:59:37 +02:00
|
|
|
|
2020-10-17 12:12:09 +02:00
|
|
|
- Uninstall Tela theme:
|
2021-01-25 17:01:12 +01:00
|
|
|
- `sudo ./install.sh -r -t tela`
|
2020-03-30 06:59:37 +02:00
|
|
|
|
2020-10-16 18:40:48 +02:00
|
|
|
## Issues / tweaks:
|
2020-01-25 16:13:33 +01:00
|
|
|
|
2020-10-16 18:40:48 +02:00
|
|
|
### Correcting display resolution:
|
2019-10-01 08:59:14 +02:00
|
|
|
|
2020-10-17 12:12:09 +02:00
|
|
|
- On the grub screen, press `c` to enter the command line
|
2020-10-16 18:40:48 +02:00
|
|
|
- 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
|
2020-01-25 16:13:33 +01:00
|
|
|
|
2020-10-16 18:40:48 +02:00
|
|
|
### Setting a custom background:
|
2020-01-25 16:13:33 +01:00
|
|
|
|
2020-10-17 16:14:09 +02:00
|
|
|
- Make sure you have `imagemagick` installed, or at least something that provides `convert`
|
2020-10-17 12:12:09 +02:00
|
|
|
- Find the resolution of your display, and make sure your background matches the resolution
|
2021-01-07 23:28:38 +01:00
|
|
|
- (1920x1080 -> --1080p, 2560x1080 -> --ultrawide, 2560x1440 -> --2k, 3440x1440 -> --ultrawide2k, 3840x2160 -> --4k)
|
2021-01-25 17:01:12 +01:00
|
|
|
- Place your custom background inside the root of the project, and name it `background.jpg`
|
|
|
|
|
- Run the installer like normal, but with -s `[YOUR_RESOLUTION]` and -t `[THEME]` and -i `[ICON]`
|
2020-10-17 12:12:09 +02:00
|
|
|
- Make sure to replace `[YOUR_RESOLUTION]` with your resolution and `[THEME]` with the theme
|
|
|
|
|
|
|
|
|
|
## 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
|
2019-11-09 01:00:53 +01:00
|
|
|
|
2021-11-04 09:16:47 +01:00
|
|
|
## Preview:
|
|
|
|
|
|
2021-05-09 15:21:29 +02:00
|
|
|
|
|
|
|
|
## Documents
|
2021-11-04 08:43:43 +01:00
|
|
|
|
2021-11-04 08:44:32 +01:00
|
|
|
[Grub2 theme reference](http://wiki.rosalab.ru/en/index.php/Grub2_theme_/_reference)
|
2021-11-04 08:43:43 +01:00
|
|
|
|
2021-11-04 08:44:32 +01:00
|
|
|
[Grub2 theme tutorial](http://wiki.rosalab.ru/en/index.php/Grub2_theme_tutorial)
|
2021-11-04 08:43:43 +01:00
|
|
|
|
