01. Overview & Architecture

Profile: v3.2
Schema validatedSource pinned
Purpose
GRUB themes branded for many Linux distributions.
Compatibility
Any distro (Server: BOTH)
Window Manager & Theme
Any WM / DE / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactUses sudo: sudo grub-mkconfig -o /boot/grub/grub.cfg
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/AdisonCavani/distro-grub-themes ~/0xtsoa-review/adisoncavani-distro-grub-themes# 1. clone to a review folder
$git -C ~/0xtsoa-review/adisoncavani-distro-grub-themes checkout --detach 6e9e018abf38c0b3ed2bff1912ecf30a94e0c917# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Clone the repository
$git clone --filter=blob:none https://github.com/AdisonCavani/distro-grub-themes
$git -C distro-grub-themes checkout 6e9e018abf38c0b3ed2bff1912ecf30a94e0c917
$cd distro-grub-themes
2Follow the upstream README
$xdg-open https://github.com/AdisonCavani/distro-grub-themes#readme
3Regenerate the boot configuration
$sudo grub-mkconfig -o /boot/grub/grub.cfg
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/adisoncavani/distro-grub-themes/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Documentation & Guide

Source: AdisonCavani/distro-grub-themesRef: 6e9e018abf
README.md|GitHub Flavored Markdown

Distro Grub Themes

![name](https://img.shields.io/github/license/AdisonCavani/distro-grub-themes) ![name](https://img.shields.io/github/v/release/AdisonCavani/distro-grub-themes) ![Build](https://github.com/AdisonCavani/distro-grub-themes/actions/workflows/update-content.yml/badge.svg?event=push)

A pack of GRUB2 themes for different Linux distributions and OSs.
It aims to replace the default GRUB look, with a nice and colorful theme.

Note

Due to lack of free time, the project is in a read-only state.

Get started

Funding

I put a lot of effort and my free time into maintaining this project.
If you appreciate that, you can buy me a coffee.

Buy Me A Coffee

Contributing

Development happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements.
Read below to learn how you can take part in improving it.

Code of Conduct

This project has adopted a Code of Conduct that we expect project participants to adhere to.
Please read the full text so that you can understand what actions will and will not be tolerated.

Contributing Guide

Read contributing guide to learn how to propose changes, bugfixes and improvements.

License

This project is licensed under GNU General Public License v3.0

Contributors

Thank you to all the people who already contributed to this project!

GitHub Flavored Markdown (github-markdown-css)README snapshot at 6e9e018abf