Forums

Skip to content

Advanced search
  • Quick links
    • Unanswered topics
    • Active topics
    • Search
  • FAQ
  • Login
  • Register
  • Board index Assistance Desktop Environments
  • Search

How to configure LUKS + Plymouth on UGRD+GRUB

Problems with GUI applications? Questions about X, KDE, Gnome, Fluxbox, etc.? Come on in. NOTE: For multimedia, go up one forum
Post Reply
Advanced search
5 posts • Page 1 of 1
Author
Message
idaru
n00b
n00b
Posts: 4
Joined: Fri Aug 15, 2025 3:53 am

How to configure LUKS + Plymouth on UGRD+GRUB

  • Quote

Post by idaru » Fri Aug 15, 2025 8:08 pm

Hi everyone (first post!),

I need some help configuring Plymouth to show a theme during the LUKS password prompt.
I've successfully installed Plymouth and configured it with a theme without any issues.
The problem is that the theme only appears after I enter the LUKS password, not during the prompt itself.

I know this is possible using hooks if you're using Dracut, but my system currently uses UGRD, and I haven't found any information about Plymouth modules for it.

Just wanting to know if it's possible and if anyone has been able to get Plymouth working with UGRD + LUKS?
Top
zen_desu
Guru
Guru
Posts: 503
Joined: Fri Oct 25, 2024 3:14 pm
Location: your area

Re: How to configure LUKS + Plymouth on UGRD+GRUB

  • Quote

Post by zen_desu » Fri Aug 15, 2025 9:54 pm

idaru wrote:Hi everyone (first post!),

I need some help configuring Plymouth to show a theme during the LUKS password prompt.
I've successfully installed Plymouth and configured it with a theme without any issues.
The problem is that the theme only appears after I enter the LUKS password, not during the prompt itself.

I know this is possible using hooks if you're using Dracut, but my system currently uses UGRD, and I haven't found any information about Plymouth modules for it.

Just wanting to know if it's possible and if anyone has been able to get Plymouth working with UGRD + LUKS?
ugrd has very basic plymouth support. (enabled by adding the `ugrd.base.plymouth` module to the `modules` definition in /etc/ugrd/config.toml). By default it tries to use the efi framebuffer which can cause some issues with plymouth.

You may be able to get it to work better by letting ugrd pull GPU drivers by setting `kmod_ignore_video = false` in /etc/ugrd/config.toml

plymouth support in ugrd is not great, especially because it doesn't have proper test coverage. I've tested it working, but it doesn't have automated test coverage and hasn't been touched in a while so your mileage may vary.
µgRD dev
Wiki writer
Top
idaru
n00b
n00b
Posts: 4
Joined: Fri Aug 15, 2025 3:53 am

Re: How to configure LUKS + Plymouth on UGRD+GRUB

  • Quote

Post by idaru » Sat Aug 16, 2025 4:54 pm

zen_desu wrote: ugrd has very basic plymouth support. (enabled by adding the `ugrd.base.plymouth` module to the `modules` definition in /etc/ugrd/config.toml). By default it tries to use the efi framebuffer which can cause some issues with plymouth.

You may be able to get it to work better by letting ugrd pull GPU drivers by setting `kmod_ignore_video = false` in /etc/ugrd/config.toml

plymouth support in ugrd is not great, especially because it doesn't have proper test coverage. I've tested it working, but it doesn't have automated test coverage and hasn't been touched in a while so your mileage may vary.

I successfully activated the Plymouth module using your recommendation. Thank you so much!

Now I'm trying to load a theme into the initramfs generated by ugrd. I've been looking at the plymouth.py code, specifically:

Code: Select all

PLYMOUTH_CONFIG_FILES = ["/etc/plymouth/plymouthd.conf", "/usr/share/plymouth/plymouthd.defaults"]
I understand that by importing my own plymouthd.conf and plymouthd.defaults, I should be able to pass a default theme to the initramfs. I am correct?h

After that, I'd just need to import my theme into the initramfs itself.

Code: Select all

dependencies = [
  "/usr/share/plymouth/themes/simple/img.png",
  "/usr/share/plymouth/themes/simple/simple.plymouth",
  "/usr/share/plymouth/themes/simple/simple.script",
  "/etc/plymouth/plymouthd.conf",
  "/usr/share/plymouth/plymouthd.defaults"
  ]
I'm still trying to get it to work, as this hasn't been enough so far. I haven't even had a chance to check the initramfs generated image yet due to being short on time.
Top
zen_desu
Guru
Guru
Posts: 503
Joined: Fri Oct 25, 2024 3:14 pm
Location: your area

Re: How to configure LUKS + Plymouth on UGRD+GRUB

  • Quote

Post by zen_desu » Sat Aug 16, 2025 6:07 pm

idaru wrote:
zen_desu wrote: ugrd has very basic plymouth support. (enabled by adding the `ugrd.base.plymouth` module to the `modules` definition in /etc/ugrd/config.toml). By default it tries to use the efi framebuffer which can cause some issues with plymouth.

You may be able to get it to work better by letting ugrd pull GPU drivers by setting `kmod_ignore_video = false` in /etc/ugrd/config.toml

plymouth support in ugrd is not great, especially because it doesn't have proper test coverage. I've tested it working, but it doesn't have automated test coverage and hasn't been touched in a while so your mileage may vary.

I successfully activated the Plymouth module using your recommendation. Thank you so much!

Now I'm trying to load a theme into the initramfs generated by ugrd. I've been looking at the plymouth.py code, specifically:

Code: Select all

PLYMOUTH_CONFIG_FILES = ["/etc/plymouth/plymouthd.conf", "/usr/share/plymouth/plymouthd.defaults"]
I understand that by importing my own plymouthd.conf and plymouthd.defaults, I should be able to pass a default theme to the initramfs. I am correct?h

After that, I'd just need to import my theme into the initramfs itself.

Code: Select all

dependencies = [
  "/usr/share/plymouth/themes/simple/img.png",
  "/usr/share/plymouth/themes/simple/simple.plymouth",
  "/usr/share/plymouth/themes/simple/simple.script",
  "/etc/plymouth/plymouthd.conf",
  "/usr/share/plymouth/plymouthd.defaults"
  ]
I'm still trying to get it to work, as this hasn't been enough so far. I haven't even had a chance to check the initramfs generated image yet due to being short on time.
I never tested themes working, just that ugrd pulls the theme files. I put a lot of time into trying to get it to "fully" function with an efi framebuffer but I don't think it's possible with plymouth.


setting `plymouth_themes = ['theme1', 'theme2']` using names that are under /usr/share/plymouth/themes should make ugrd add those themes to the image. https://github.com/desultory/ugrd/blob/ ... h.toml#L31

it also attempts to read the plymouth config file for defined themes: https://github.com/desultory/ugrd/blob/ ... uth.py#L15

In most cases, you shouldn't have to manually define dependencies in ugrd, but if something isn't being pulled correctly here, that's the best way to force a file to be copied into the image.

The toml files in the project are module definitions, they use the same style as user config in /etc/ugrd/config.toml, but generally shouldn't be directly edited. You can think of the user config as the "final" module which applies over any project defaults. If you added a "dependencies = " definition in your config, it wouldn't override things, it would add, because of how config processing works.
µgRD dev
Wiki writer
Top
idaru
n00b
n00b
Posts: 4
Joined: Fri Aug 15, 2025 3:53 am

Re: How to configure LUKS + Plymouth on UGRD+GRUB

  • Quote

Post by idaru » Mon Aug 18, 2025 1:58 pm

zen_desu wrote: I never tested themes working, just that ugrd pulls the theme files. I put a lot of time into trying to get it to "fully" function with an efi framebuffer but I don't think it's possible with plymouth.


setting `plymouth_themes = ['theme1', 'theme2']` using names that are under /usr/share/plymouth/themes should make ugrd add those themes to the image. https://github.com/desultory/ugrd/blob/ ... h.toml#L31

it also attempts to read the plymouth config file for defined themes: https://github.com/desultory/ugrd/blob/ ... uth.py#L15

In most cases, you shouldn't have to manually define dependencies in ugrd, but if something isn't being pulled correctly here, that's the best way to force a file to be copied into the image.

The toml files in the project are module definitions, they use the same style as user config in /etc/ugrd/config.toml, but generally shouldn't be directly edited. You can think of the user config as the "final" module which applies over any project defaults. If you added a "dependencies = " definition in your config, it wouldn't override things, it would add, because of how config processing works.
I will try to get custom themes working, thank you very much; it was really helpful in understanding how ugRD works.

Have a great day!
Top
Post Reply

5 posts • Page 1 of 1

Return to “Desktop Environments”

Jump to
  • Assistance
  • ↳   News & Announcements
  • ↳   Frequently Asked Questions
  • ↳   Installing Gentoo
  • ↳   Multimedia
  • ↳   Desktop Environments
  • ↳   Networking & Security
  • ↳   Kernel & Hardware
  • ↳   Portage & Programming
  • ↳   Gamers & Players
  • ↳   Other Things Gentoo
  • ↳   Unsupported Software
  • Discussion & Documentation
  • ↳   Documentation, Tips & Tricks
  • ↳   Gentoo Chat
  • ↳   Gentoo Forums Feedback
  • ↳   Duplicate Threads
  • International Gentoo Users
  • ↳   中文 (Chinese)
  • ↳   Dutch
  • ↳   Finnish
  • ↳   French
  • ↳   Deutsches Forum (German)
  • ↳   Diskussionsforum
  • ↳   Deutsche Dokumentation
  • ↳   Greek
  • ↳   Forum italiano (Italian)
  • ↳   Forum di discussione italiano
  • ↳   Risorse italiane (documentazione e tools)
  • ↳   Polskie forum (Polish)
  • ↳   Instalacja i sprzęt
  • ↳   Polish OTW
  • ↳   Portuguese
  • ↳   Documentação, Ferramentas e Dicas
  • ↳   Russian
  • ↳   Scandinavian
  • ↳   Spanish
  • ↳   Other Languages
  • Architectures & Platforms
  • ↳   Gentoo on ARM
  • ↳   Gentoo on PPC
  • ↳   Gentoo on Sparc
  • ↳   Gentoo on Alternative Architectures
  • ↳   Gentoo on AMD64
  • ↳   Gentoo for Mac OS X (Portage for Mac OS X)
  • Board index
  • All times are UTC
  • Delete cookies

© 2001–2026 Gentoo Foundation, Inc.

Powered by phpBB® Forum Software © phpBB Limited

Privacy Policy

 

 

magic