{"id":13595678,"url":"https://github.com/vinceliuice/grub2-themes","last_synced_at":"2025-04-09T13:33:18.360Z","repository":{"id":38237858,"uuid":"114718155","full_name":"vinceliuice/grub2-themes","owner":"vinceliuice","description":"Modern Design theme for Grub2","archived":false,"fork":false,"pushed_at":"2024-12-17T05:22:06.000Z","size":38996,"stargazers_count":3619,"open_issues_count":55,"forks_count":249,"subscribers_count":28,"default_branch":"master","last_synced_at":"2024-12-17T06:23:40.660Z","etag":null,"topics":[],"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/vinceliuice.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2017-12-19T04:11:25.000Z","updated_at":"2024-12-17T06:11:26.000Z","dependencies_parsed_at":"2023-02-10T13:15:19.177Z","dependency_job_id":"2cef6457-f0c7-420f-abb1-52a006ab2d1f","html_url":"https://github.com/vinceliuice/grub2-themes","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2Fgrub2-themes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2Fgrub2-themes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2Fgrub2-themes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2Fgrub2-themes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vinceliuice","download_url":"https://codeload.github.com/vinceliuice/grub2-themes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248049634,"owners_count":21039252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-01T16:01:55.389Z","updated_at":"2025-04-09T13:33:15.007Z","avatar_url":"https://github.com/vinceliuice.png","language":"Shell","funding_links":[],"categories":["Shell","GRUB"],"sub_categories":["VSCode"],"readme":"![banner](banner.png?raw=true)\n\n## Installation:\nUsage:  `sudo ./install.sh [OPTIONS...]`\n```\n  -t, --theme                 theme variant(s)          [tela|vimix|stylish|whitesur]       (default is tela)\n  -i, --icon                  icon variant(s)           [color|white|whitesur]              (default is color)\n  -s, --screen                screen display variant(s) [1080p|2k|4k|ultrawide|ultrawide2k] (default is 1080p)\n  -c, --custom-resolution     set custom resolution     (e.g., 1600x900)                    (disabled in default)\n  -r, --remove                remove theme              [tela|vimix|stylish|whitesur]       (must add theme name option, default is tela)\n\n  -b, --boot                  install theme into '/boot/grub' or '/boot/grub2'\n  -g, --generate              do not install but generate theme into chosen directory       (must add your directory)\n\n  -h, --help                  show this help\n```\n*If no options are used, a user interface *`dialog`* will show up instead*\n\n### Examples:\n - Install Tela theme on 2k display device:\n```sh\nsudo ./install.sh -t tela -s 2k\n```\n - Install Tela theme with custom resolution:\n```sh\nsudo ./install.sh -t tela -c 1600x900\n```\n - Install Tela theme into /boot/grub/themes:\n```sh\nsudo ./install.sh -b -t tela\n```\n - Uninstall Tela theme:\n```sh\nsudo ./install.sh -r -t tela\n```\n\n## Installation with NixOS:\nTo use this theme with NixOS you will have to enable [flakes](https://wiki.nixos.org/wiki/flakes). Before you do this, please inform yourself if you really want to, because flakes are still an unstable feature.\nFirst you will have to add grub2 to your `flake.nix` file as a new input.\n```nix\n# flake.nix\n{\n  description = \"NixOS configuration\";\n  inputs = {\n    nixpkgs.url = \"github:nixos/nixpkgs/nixos-unstable\";\n    # Add grub2 themes to your inputs ...\n    grub2-themes = {\n      url = \"github:vinceliuice/grub2-themes\";\n    };\n  };\n  outputs = inputs@{ nixpkgs,  grub2-themes, ... }: {\n    nixosConfigurations = {\n      my_host = nixpkgs.lib.nixosSystem {\n        system = \"x86_64-linux\";\n        specialArgs = { inherit inputs; };\n        # ... and then to your modules\n        modules = [\n          ./configuration.nix\n          grub2-themes.nixosModules.default\n        ];\n      };\n    };\n  };\n}\n```\nAfter that, you can configure the theme as shown below. In this example it is inside the `configuration.nix` file but it can be any file you choose.\n```nix\n# configuration.nix\n{ inputs, config, pkgs, lib, ... }:\n{\n  boot.loader.grub = { ... };\n  boot.loader.grub2-theme = {\n    enable = true;\n    theme = \"stylish\";\n    footer = true;\n    customResolution = \"1600x900\";  # Optional: Set a custom resolution\n  };\n}\n```\n\n## Issues / tweaks:\n### Correcting display resolution:\n - On the grub screen, press `c` to enter the command line\n - Enter `vbeinfo` or `videoinfo` to check available resolutions\n - Open `/etc/default/grub`, and edit `GRUB_GFXMODE=[height]x[width]x32` to match your resolution\n - Finally, run `grub-mkconfig -o /boot/grub/grub.cfg` to update your grub config\n\n### Setting a custom background:\n - Make sure you have `imagemagick` installed, or at least something that provides `convert`\n - Find the resolution of your display, and make sure your background matches the resolution\n   - 1920x1080 \u003e\u003e 1080p\n   - 2560x1080 \u003e\u003e ultrawide\n   - 2560x1440 \u003e\u003e 2k\n   - 3440x1440 \u003e\u003e ultrawide2k\n   - 3840x2160 \u003e\u003e 4k\n - Place your custom background inside the root of the project, and name it `background.jpg`\n - Run the installer like normal, but with -s `[YOUR_RESOLUTION]` and -t `[THEME]` and -i `[ICON]`\n   - Make sure to replace `[YOUR_RESOLUTION]` with your resolution and `[THEME]` with the theme\n - Alternatively, use the `-c` option to set a custom resolution\n\n## Contributing:\n - If you made changes to icons, or added a new one:\n   - Delete the existing icon, if there is one\n   - Run `cd assets; ./render-all.sh`\n - Create a pull request from your branch or fork\n - If any issues occur, report then to the [issue](https://github.com/vinceliuice/grub2-themes/issues) page\n\n## Preview:\n![preview](preview.png?raw=true)\n\n## Documents\n\n[Grub2 theme reference](https://wiki.rosalab.ru/en/index.php/Grub2_theme_/_reference)  \n\n[Grub2 theme tutorial](https://wiki.rosalab.ru/en/index.php/Grub2_theme_tutorial)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinceliuice%2Fgrub2-themes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvinceliuice%2Fgrub2-themes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinceliuice%2Fgrub2-themes/lists"}