summaryrefslogtreecommitdiff
path: root/.github/README.md
blob: 4b49efbc7a7eecbfb0858d7ecb05b972b1b537d9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# Blue Screen of Life

Embrace the Blue Screen. 

Own this grub theme. Make it the first thing you see...

![preview image](preview.png)

# How to Install

> :warning: **Make sure you understand what you are doing. Installation of the theme can cause problems in your system if done incorrectly** 


## Manual Installation (preferred method) 

- Clone the repo 

```
git clone https://github.com/harishnkr/bsol.git
```

- Copy the entire `bsol/` directory to `/boot/grub/themes/` or similar path depending on your distribution

- Change the `GRUB_THEME` line in `/etc/default/grub` file:

```
GRUB_THEME="/boot/grub/themes/bsol/theme.txt"
```
- Update GRUB with sudo privileges.

For Arch based systems:

```
sudo grub-mkconfig -o /boot/grub/grub.cfg
```


For Debian based systems:

```
sudo update-grub
```

For Fedora based systems:
- when using BIOS  
    ```
    sudo grub2-mkconfig -o /boot/grub2/grub.cfg
    ```

- when using EFI
    ```
    sudo grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg
    ```

## Using Package manager

If you use Arch linux or derivatives, use this [package](https://aur.archlinux.org/packages/grub-theme-bsol-git)
run `grub-install --themes=bsol` followed by `grub-mkconfig -o /boot/grub/grub.cfg"` both with `sudo` privileges.


## Configuration

### Choosing font

By default, the theme uses `victor mono italic` font. Alternatives are as follows:

- Victor Mono Regular 16

To change it, change the line containing the terminal font in the `theme.txt` file. To suggest another font, open a new issue.

## Troubleshooting

Some fixes for issues that may help are as follows. All feedbacks are appreciated

- Make sure this line is commented with a `#` in the beginning:
    ```
    GRUB_TERMINAL_OUTPUT="console"
    ```
- Change resolution with this line:
    ```
    GRUB_GFXMODE="[x_res]x[y_res]x32"
    ```
    (change x_res and y_res to your screen resolution, e.g. 1920x1080)


# Credits


- [This amazing guide](http://wiki.rosalab.ru/en/index.php/Grub2_theme_tutorial)
- [y0uCeF](https://github.com/y0uCeF) for helping with the AUR package