https://github.com/inledgroup/pulsar.grub
https://github.com/inledgroup/pulsar.grub
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/inledgroup/pulsar.grub
- Owner: InledGroup
- License: other
- Created: 2025-09-27T07:44:19.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-04-04T14:25:34.000Z (2 months ago)
- Last Synced: 2026-04-04T16:52:36.795Z (2 months ago)
- Language: Shell
- Size: 43.6 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pulsar GRUB Theme
## Installation:
Usage: `./install.sh [OPTIONS...]`
```
-t, --theme Background theme variant(s) [window|sidebar] (default is window)
-s, --screen Screen display variant(s) [1080p|2k|4k] (default is 1080p)
-r, --remove Remove/Uninstall theme (must add theme options, default is Particle-circle-window)
-b, --boot Install theme into '/boot/grub' or '/boot/grub2'
-h, --help Show this help
```
_If no options are used, a user interface `dialog` will show up instead_
### Examples:
- Install window theme on 2k display device:
```sh
sudo ./install.sh -t window -s 2k
```
- Install sidebar theme into /boot/grub/themes:
```sh
sudo ./install.sh -b -t sidebar
```
- Uninstall window theme:
```sh
sudo ./install.sh -r -t window
```
## Issues / tweaks:
### Correcting display resolution:
- 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
### Setting a custom background:
- Make sure you have `imagemagick` installed, or at least something that provides `convert`
- Find the resolution of your display, and make sure your background matches the resolution
- 1920x1080 >> 1080p
- 2560x1440 >> 2k
- 3840x2160 >> 4k
- 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]`
- 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](issues) page
## Preview:
## Documents
[Grub2 theme reference](https://wiki.rosalab.ru/en/index.php/Grub2_theme_/_reference)
[Grub2 theme tutorial](https://wiki.rosalab.ru/en/index.php/Grub2_theme_tutorial)