{"id":24313646,"url":"https://github.com/stuarthayhurst/argon-grub-theme","last_synced_at":"2026-03-14T22:39:10.876Z","repository":{"id":44579641,"uuid":"305113721","full_name":"stuarthayhurst/argon-grub-theme","owner":"stuarthayhurst","description":"Configurable, modern theme for the GRUB bootloader, containing backgrounds, icons, fonts and styling","archived":false,"fork":false,"pushed_at":"2025-12-11T22:56:46.000Z","size":25391,"stargazers_count":78,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-02-11T02:25:44.243Z","etag":null,"topics":["grub-bootloader","grub-theme","modern-theme","theme","wallpaper"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stuarthayhurst.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"stuarthayhurst","custom":"https://paypal.me/stuartahayhurst"}},"created_at":"2020-10-18T13:56:37.000Z","updated_at":"2026-01-02T09:59:55.000Z","dependencies_parsed_at":"2024-07-22T00:30:47.772Z","dependency_job_id":"3342b1e7-0e05-4a39-8b0d-c2537cb7c40c","html_url":"https://github.com/stuarthayhurst/argon-grub-theme","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/stuarthayhurst/argon-grub-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuarthayhurst%2Fargon-grub-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuarthayhurst%2Fargon-grub-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuarthayhurst%2Fargon-grub-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuarthayhurst%2Fargon-grub-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stuarthayhurst","download_url":"https://codeload.github.com/stuarthayhurst/argon-grub-theme/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuarthayhurst%2Fargon-grub-theme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30520754,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-14T19:51:21.629Z","status":"ssl_error","status_checked_at":"2026-03-14T19:51:12.959Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["grub-bootloader","grub-theme","modern-theme","theme","wallpaper"],"created_at":"2025-01-17T09:12:50.250Z","updated_at":"2026-03-14T22:39:10.867Z","avatar_url":"https://github.com/stuarthayhurst.png","language":"Shell","funding_links":["https://github.com/sponsors/stuarthayhurst","https://paypal.me/stuartahayhurst"],"categories":[],"sub_categories":[],"readme":"## argon-grub-theme\n - Configurable, modern theme for the GRUB, containing backgrounds, icons, fonts and styling\n   - Backgrounds, fonts and fontsize can all be customised\n   - Wallpaper source files can be found [here](https://github.com/stuarthayhurst/argon-wallpapers)\n   - Some of the icons used are from [here](https://github.com/vinceliuice/grub2-themes)\n - Any donations are greatly appreciated :)\n\n## Installation:\nUsage:  `sudo ./install.sh [OPTIONS]`\n\n|  Options:         | Description: |\n|:------------------|:-------------|\n| -h , --help       | Show a help page |\n| -i , --install    | Install the grub theme (root) |\n| -u , --uninstall  | Uninstall the grub theme (root) |\n| -e , --boot       | Install the grub theme into `/boot/grub/themes` |\n| -p , --preview    | Preview the grub theme (Works with other options, non-root) |\n| -b , --background | Choose a background image (must be a .png, or bundled with the project) \u003cbr\u003e - Leave blank to view available backgrounds|\n| -c , --custom     | Use a solid colour as a background (HTML value, must be quoted)\n| -r , --resolution | Select the display resolution \u003cbr\u003e - Leave blank to view available resolutions |\n| --icons           | Choose whether to use `coloured` or `colourless` icons |\n| -f , --font       | Specify which font to use (file) \u003cbr\u003e - Leave blank to view available fonts |\n| -fc, --fontcolour | Use a specific font colour (HTML (must be quoted) and SVG 1.0 colours supported) \u003cbr\u003e - Use the format: -fc \"textcolour,selectedcolour\" |\n| -fs, --fontsize   | Use a specific font size |\n| -l , --bold       | Force font to be bold |\n| -hl, --help-label | Add a help label to the bottom of the theme |\n\nRequired arguments: [--install + --background / --uninstall / --preview]\n - **If the repository is updated, `make clean` should be run, to erase cached assets**\n\n## Fixing common problems:\n - Secure Boot can cause some assets (primarily fonts) to fail to load, as they're not signed\n - The simplest fix to to disable Secure Boot in BIOS\n - Alternatively, the files can be signed and enrolled after installation, but this method varies by distro\n\n## Examples:\n - Install the theme for a 4k display, using the `Night` wallpaper:\n   - `sudo ./install.sh --install --resolution 4k --background Night`\n\n - Install the theme for a 4k display, using the `Night` wallpaper and a font size of 32:\n   - `sudo ./install.sh --install --resolution 4k --background Night --fontsize 32`\n\n - Install the theme for an unknown resolution, using the `Crystals` wallpaper:\n   - `sudo ./install.sh --install --resolution custom --background Crystals`\n\n - Install the theme for a custom resolution (1024x720), using a solid magenta wallpaper:\n   - `sudo ./install.sh --install --resolution 1024x720 --custom \"#ff00ff\"`\n\n - Preview the theme with a fontsize of 32, a white font colour, black selected font colour and white timer colour:\n   - `./install.sh -p -b Crystals -fs 32 -fc \"white,#000000,white\"`\n\n - Preview the theme with a different font:\n   - `./install.sh -p -b Crystals -f Terminus.ttf`\n\n - Install the theme into /boot/grub/themes:\n   - `sudo ./install.sh -i -e -b Night`\n\n - Uninstall the theme:\n   - `sudo ./install.sh -u`\n\n## Screenshots:\n_Preview is compressed, the backgrounds are higher quality_\n![Gallery](docs/Gallery.gif)\n - Some individual images at end of document\n\n## Dependencies:\n  #### Mandatory:\n - `make` - Used for the build system\n - `imagemagick / convert` - Used to generate backgrounds with custom colours\n - `inkscape` - Used to generate pngs from svgs (Used by `make generate-all`)\n   - `inkscape` is needed if the fontsize used isn't 16, 24 or 32\n   - If `optipng` is present, generated icons will be losslessly compressed\n  #### Optional:\n - `python3` - Used when generating icons, or when using a custom fontsize\n - `optipng` - Used to losslessly compress pngs (Used by `make compress-backgrounds`, `make generate-gif`, `make generate-icons` and `make generate-select`)\n - `grub2-theme-preview` - Used to preview themes (Used by --preview)\n\n## Updating:\n - Clone the repository: `git clone https://github.com/stuarthayhurst/argon-grub-theme.git`\n   - If it's already cloned, just run `git pull`\n - **Clear the asset cache: `make clean`**\n - Install like normal\n\n## Preview the theme:\n - Follow the instructions at [grub2-theme-preview](https://github.com/hartwork/grub2-theme-preview) to install the program\n   - Your distro might require using a virtual environment, this can be done with the following:\n     - `python3 -m venv .venv`\n     - `source .venv/bin/activate`\n     - `pip3 install grub2-theme-preview`\n     - Install grub2-theme-preview's dependencies using your distro's package manager\n - Run the install script with your desired options, but replace --install / -i with --preview / -p\n - For example: `./install.sh --preview --background Crystals.png --resolution 4k`\n\n## Using a different resolution:\n - Use `./install.sh -r` to list available resolutions, and `./install.sh -r [RESOLUTION]` to use one\n - Any resolution can be used with `./install.sh -r custom` and a custom background\n\n## Using a custom background:\n - Find the resolution of your display, and make sure your background matches the resolution\n - Place your custom background inside the root of the project\n - Run the installer like normal, but with `--background [filename.png]` and `--resolution [YOUR_RESOLUTION]`\n   - Resolutions:\n     - 16:9: (`1920x1080` -\u003e 1080p, `2560x1440` -\u003e 2k, `3840x2160` -\u003e 4k)\n     - 16:10: (`1920x1200`, `2240x1400`, `3840x2400`)\n   - Make sure to replace `[YOUR_RESOLUTION]` with your resolution and `[THEME]` with the theme\n - To use a custom colour background, don't pass `--background`\n   - Pass `--resolution [YOUR_RESOLUTION] --custom \"[COLOUR_CODE]\"`\n   - For example, `--resolution 1920x1080 --custom \"#ff00ff\"` to use a magenta 1080p background\n\n## Forcing an icon:\n - Find the name / class of the icon in `assets/svg/icons/`\n   - For example, `assets/svg/icons/linuxmint.svg` would be `linuxmint`\n - Add the class to the corresponding entry in `/boot/grub/grub.cfg`:\n   - Change: `menuentry 'Linux Mint 18.3 Cinnamon 64-bit' --class ubuntu --class gnu-linux --class gnu`\n   - To: `menuentry 'Linux Mint 18.3 Cinnamon 64-bit' --class linuxmint --class ubuntu --class gnu-linux --class gnu`\n - Save the file and exit\n\n## Adding your own icon:\n - Add a `32x32` `.svg` of the icon into `assets/svg/icons/`\n   - If using colourless icons or planning to push the changes upstream, put a colourless copy in `assets/svg/icons-colourless`\n - Make sure `inkscape`, `python3` and `optipng` are installed\n - Run `make generate-icons -j$(nproc)`\n - Install as normal\n - If those dependencies can't be installed, or you can't use a `.svg`, place `32x32`, `48x48` and `64x64` versions of the icon in the corresponding directories in `assets/icons/`\n - Install as normal, but if `--fontsize` is used, the custom icon won't be used\n\n## Gallery:\n![Crystals](docs/1-Crystals.png)\n![Dawn](docs/2-Dawn.png)\n![Dusk](docs/3-Dusk.png)\n![Waves](docs/4-Waves.png)\n![Dark Waves](docs/5-DarkWaves.png)\n![Grey](docs/6-Grey.png)\n![Night](docs/7-Colours.png)\n![Multi-distro Crystals](docs/8-Crystals.png)\n![Hills](docs/9-Hills.png)\n![Magenta](docs/10-Magenta.png)\n\n## Makefile options:\n - Makefile respects core count specified by `-j[Core count]`\n - `make clean` - Remove assets generated at build time\n - `make full-clean` - Remove all generated assets\n - `make generate-all` - Generate all assets\n - `make compress-backgrounds` - Compress backgrounds losslessly\n\n## Contributing:\n - If you made changes to any images, or added a new one:\n   - Run `make full-clean`\n   - Run `make generate-all`\n - If the change was to a background, scale the background for each resolution, then:\n   - Run `make compress-backgrounds`\n - Create a pull request from your branch or fork\n - If any issues occur, report them to the [issue](https://github.com/stuarthayhurst/argon-grub-theme/issues) page\n - Thank you :)\n\n## Copyright and credits:\n - Terminus font: Copyright (c) 2019 Dimitar Toshkov Zhekov, `fonts/Terminus-License.txt`\n - Unifont: The GNU Project - `fonts/Unifont-License.txt`\n - Theme originally based off of [grub2-themes](https://github.com/vinceliuice/grub2-themes)\n   - Code is upstreamed where possible\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuarthayhurst%2Fargon-grub-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstuarthayhurst%2Fargon-grub-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuarthayhurst%2Fargon-grub-theme/lists"}