⚡ GrubForge v1.0.0 — First Stable Release

Released: April 4, 2026

GrubForge is now on the AUR!

yay -S grubforge

What's new

• 📦 AUR package — install with yay -S grubforge
• 🚀 System executable — run with sudo grubforge from anywhere
• 🔧 PKGBUILD installs to /usr/lib/grubforge/ with launcher at /usr/bin/grubforge
• 📖 Man page installed to /usr/share/man/man1/grubforge.1
• 📸 Screenshots in README

Install

yay -S grubforge

AUR page

https://aur.archlinux.org/packages/grubforge

Full changelog

See CHANGELOG in README for complete version history.

📖 GrubForge v0.9.0 — Man Page

Released: April 4, 2026

What's new

• 📖 Man page added — grubforge.1 installed to the repo
• Documents all 5 screens, all keybindings, all managed file paths
• Built-in SEE ALSO references to grub-mkconfig, grub-install, os-prober
• Test locally with: man ./grubforge.1

Full changelog

See CHANGELOG in README for complete version history.

📸 GrubForge v0.8.0 — Screenshots

Released: April 4, 2026

What's new

• 📸 Screenshots added to README — all five screens captured and published
  • Dashboard
  • Config Editor
  • Theme Browser
  • Backup & Restore
  • Boot Entries

Full changelog

See CHANGELOG in README for complete version history.

Theme Browser Help Guide — GrubForge v0.7.0

Released: April 4, 2026

What's new

• Press H in the Theme Browser to open the installation guide
• Explains exactly where to save themes (/boot/grub/themes/)
• Shows correct folder structure with examples
• Step by step installation instructions
• Curated list of recommended theme sources with URLs:
  • Catppuccin Mocha: https://github.com/catppuccin/grub
  • Vimix: https://github.com/vinceliuice/grub2-themes
  • Sleek: https://github.com/sandesh236/sleek--themes
  • Many more: https://www.gnome-look.org/browse?cat=109
• Tips on required GRUB settings (gfxterm, gfxmode) for themes to display
• Press H again or select a theme to close the help

Full changelog

See CHANGELOG in README for complete version history.

OS Detection — GrubForge v0.6.0

Released: April 4, 2026

What's new

• Detect other operating systems installed on your drives directly from Boot Entries
• Automatically checks if os-prober is installed and enabled on screen load
• Install os-prober via pacman with one click if missing
• Enable os-prober in /etc/default/grub with automatic backup before writing
• Scan button runs os-prober and displays all detected OSes with device and type info
• Install and Enable buttons appear only when needed — hidden when already done
• Works seamlessly with existing grub-mkconfig regeneration flow

How it works

1. Go to Boot Entries screen (press 5)
2. Scroll down to Detect Other Operating Systems
3. If os-prober is not installed, click Install os-prober
4. If os-prober is disabled, click Enable os-prober
5. Click Scan for OSes to detect other operating systems
6. Go to Config Editor and press Ctrl+R to regenerate grub.cfg
7. Detected OSes will appear in your boot menu on next boot

Full changelog

See CHANGELOG in README for complete version history.

➕ GrubForge v0.5.0 — Custom Boot Entry Creation

Released: April 4, 2026

What's new

• ➕ Add custom boot entries directly from the Boot Entries screen
• 📋 Four built-in templates:
  • Linux — boot a Linux kernel with standard parameters
  • Chainload — chainload another bootloader (e.g. Windows EFI)
  • Memtest — boot memtest86+ for memory diagnostics
  • Blank — start from scratch with a minimal template
• ✏ Raw block editor — full control over the menuentry commands
• 👁 Preview Template — fills the editor with your chosen template and entry title
• ✅ Custom entries are added to the list and saved with the same flow as reordering and renaming

How it works

1. Type your entry title in the Entry title field
2. Select a template from the dropdown
3. Click Preview Template to load the template into the editor
4. Edit the block as needed — replace YOUR-UUID-HERE with your actual partition UUID
5. Click Add Entry to append it to the boot list
6. Press S to save and apply

Full changelog

See CHANGELOG in README for complete version history.

✏ GrubForge v0.4.0 — Boot Entry Renaming

Released: April 3, 2026

What's new

• ✏ Rename any boot entry directly from the Boot Entries screen
• 🔄 Rename input pre-fills with the current entry name when selected
• ✅ Renamed entries are preserved correctly when saving custom order
• 🔒 Only the display name changes — all boot commands stay identical and safe

How it works

Select any entry in the Boot Entries screen, type a new name in the Rename field, and press Enter or click Rename. Press S to save and apply. The entry will show your custom name in the GRUB boot menu on next boot.

Full changelog

See CHANGELOG in README for complete version history.

🖥 GrubForge v0.3.0 — Boot Entries Manager

Released: April 2, 2026

What's new

• 🖥 Boot Entries screen — view all GRUB boot entries parsed directly from /boot/grub/grub.cfg
• ↕ Reorder entries — move entries up and down with K/J keys or buttons
• 💾 Save custom order — writes your order to /etc/grub.d/40_custom and disables auto-generate scripts
• ↺ Restore original — re-enables all scripts and clears custom order with one button
• 🔧 Script status panel — shows which /etc/grub.d/ scripts are enabled or disabled
• 🎨 Color coded sources — entries are color coded by source (Arch Linux, OS Prober, UEFI, BTRFS Snapshots)

How boot entry reordering works

GrubForge uses the same approach as grub-customizer:

1. Your desired order is written to /etc/grub.d/40_custom
2. Auto-generate scripts (10_linux, 30_os-prober, etc.) are disabled so they don't override your order
3. grub-mkconfig is run automatically to compile the new order
4. Everything is fully reversible with the Restore Original button

Notes

• Requires sudo to modify /etc/grub.d/ scripts
• BTRFS snapshot entries (41_snapshots-btrfs) are preserved and not disabled
• Boot entry reordering survives kernel updates as long as custom order is active

🎨 GrubForge v0.2.0 — Theme Browser

Released: April 2, 2026

What's new

• 🎨 Theme Browser — automatically scans /boot/grub/themes/ for installed themes
• 🎨 Color palette preview — visual color swatches extracted from each theme's theme.txt
• 📄 theme.txt preview — syntax highlighted raw file view
• ✓ One-click apply — sets GRUB_THEME in /etc/default/grub with automatic backup
• 🟢 Active indicator — shows which theme is currently set with a green dot
• 🔧 Fixed — graphical terminal settings (GRUB_TERMINAL_OUTPUT=gfxterm) for themes to display correctly

Notes

• Themes must be installed in /boot/grub/themes/ to appear in the browser
• After applying a theme, press Ctrl+R in Config Editor to regenerate grub.cfg
• Manually downloaded themes placed in the themes folder will appear automatically

⚡ GrubForge v0.1.0 — Initial Release

Released: April 1, 2026

First public release of GrubForge — a TUI application for managing GRUB bootloader on Linux.

What's included

• 🏠 Dashboard — system overview showing GRUB config status and active settings
• 🔧 Config Editor — view and edit all 17 GRUB settings with descriptions and live validation
• 🗂 Backup & Restore — timestamped backups created automatically before every change
• 🔄 grub-mkconfig integration — regenerate boot menu in one keystroke
• 🌙 Catppuccin Mocha — beautiful dark theme throughout

Installation

sudo pacman -S python-textual python-rich
git clone https://github.com/jetomev/grubforge.git
cd grubforge
sudo python main.py

Notes

• Developed and tested on Arch Linux with KDE Plasma on Wayland
• Run without sudo for safe read-only demo mode