Preview a GRUB 2.x theme using KVM/QEMU
Project description
About
grub2-theme-preview came into life when I was looking around for available GRUB 2.x themes and wanted a way to quickly see a theme in action without rebooting real hardware.
It takes a theme folder (or just a single picture),
creates a temporary bootable image using grub2-mkrescue
and launches
that image in a virtual machine using KVM/QEMU, all without root privileges.
(Showing theme gutsblack-archlinux)
Installation
To install the latest release from PyPI:
# pip install --user grub2-theme-preview
To install from a Git clone for development:
# pip install --user --editable .
Please make sure to install these non-PyPI dependencies as well:
grub2-mkrescue
(can be installed asgrub-mkrescue
on some systems)- QEMU — hypervisor that performs hardware virtualization
- mtools — collection of utilities to access MS-DOS
- libisoburn — frontend which enables creation and expansion of the ISO format
Usage
# grub2-theme-preview --help
usage: grub2-theme-preview [-h] [--image] [--grub-cfg PATH] [--verbose]
[--resolution WxH] [--timeout SECONDS] [--version]
[--grub2-mkrescue COMMAND] [--qemu COMMAND]
[--xorriso COMMAND] [--debug]
[--plain-rescue-image]
PATH
positional arguments:
PATH Path of theme directory (or image file) to preview
optional arguments:
-h, --help show this help message and exit
--image Preview a background image rather than a whole theme
--grub-cfg PATH Path of custom grub.cfg file to use (default:
/boot/grub{2,}/grub.cfg)
--verbose Increase verbosity
--resolution WxH Set a custom resolution, e.g. 800x600
--timeout SECONDS Set timeout in whole seconds or -1 to disable
(default: 30 seconds)
--version show program's version number and exit
command location arguments:
--grub2-mkrescue COMMAND
grub2-mkrescue command (default: grub-mkrescue)
--qemu COMMAND KVM/QEMU command (default: qemu-system-<machine>)
--xorriso COMMAND xorriso command (default: xorriso)
debugging arguments:
--debug Enable debugging output
--plain-rescue-image Use unprocessed GRUB rescue image with no theme
patched in; useful for checking if a plain GRUB rescue
image shows up a GRUB shell, successfully.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
grub2-theme-preview-1.4.2.tar.gz
(198.8 kB
view hashes)
Built Distribution
Close
Hashes for grub2-theme-preview-1.4.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd3146d4532ad2711e84156503e6b842387ce3a903f7f66349da693151164053 |
|
MD5 | 4aeda8a3ed6d1c9e36583c72c7a15407 |
|
BLAKE2b-256 | efc3f606d8ae5b7115f37f432416dfd657d5dfacb0c5d82d0cd73542c1106036 |
Close
Hashes for grub2_theme_preview-1.4.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56956a23aa993e782d8b817466527785be453c0e8e93b2447ee9a1e438636f9b |
|
MD5 | 0e12d72daa463b21e2df482933af3833 |
|
BLAKE2b-256 | 3c6b3ab8832d2183660e9d76f6cda5678dd83aa79f561c3c0ad0a9500d994ea7 |