GRUB-KBDCOMP(1)

💅 GRUB-KBDCOMP 💅

okay so bestie, welcome to grub-kbdcomp — it's a User Commands situation, and it exists to generate a GRUB keyboard layout file. that's the whole vibe. iykyk.

---

✨ SYNOPSIS ✨

grub-kbdcomp -o OUTPUT CKBMAP_ARGUMENTS...

like. that's it. that's the whole call. -o OUTPUT then a pile of CKBMAP_ARGUMENTS... and you're done, periodt.

---

🦋 DESCRIPTION 🦋

so here's what's actually happening, no cap: grub-kbdcomp takes an X keyboard layout description — the kind written in the keymaps(5) format — and processes it into a format that can be used by GRUB's keymap command. literally a glow-up for your keymap. it converts, it slays, it hands GRUB something it can actually read. 💖

bottom line, fr fr: make GRUB keyboard layout file.

grub-kbdcomp generates a keyboard layout for GRUB using ckbcomp. that's the engine under the hood, okay? respect her. 👑

🎀 the flags 🎀

• -h, --help — prints this message and dips. exit, stage left. 🫶
• -V, --version — prints the version information and then also dips. ✨
• -o, --output=FILE — saves the output in FILE. and bestie, listen: this one is [required]. not optional. not "maybe later." required. the whole thing falls apart without it. 😭

🚨 vibe check: no -o, no output file. don't do that to yourself.

---

💀 REPORTING BUGS 💀

found a bug? be a good citizen and report it to <bug-grub@gnu.org>. tell them what happened, they'll handle it. 🐛✉️

---

🌈 SEE ALSO 🌈

• grub-mklayout(8) — the sibling, go say hi 👋

the full documentation for grub-kbdcomp is maintained as a Texinfo manual. if the info and grub-kbdcomp programs are properly installed at your site, then this command:

info grub-kbdcomp

should give you access to the complete manual. iconic behavior honestly. 🔥

---

and that's the page, bestie!! stay slaying, keep your keymaps cute 🌸💜

🎀 sign-off szn: this was grub-kbdcomp (that's the source/version bit, with the empty () right there in the footer), dated September 2026. drink some water. 💖