This weekend I wanted to make the boot process on my Arch Linux machine look more consistent with the rest of its environment. A while back I configured a quiet-boot setup to minimise unnecessary steps or messages appearing between switching on the device and reaching the X11 desktop. The last thing that remained in making the bootup spotless was the cryptsetup password prompt used in early userspace to unlock my root partition. It was u g l y.

After experimenting with plymouth and it's various themes (which do look pretty nice), the extra 5 seconds of boot time just isn't acceptable. Like, come on, I want it to be perfect. I'm a big fan of bitmap fonts and pixel art so I figured I could hack together some kind of text-based display for the password prompt using symbols and box-drawing characters.


First though, I needed to change the TTY font before reaching that prompt. For this the arch wiki had the answer ready so this was a quick job: simply define FONT in /etc/vconsole.conf to the name of an available psf font (look inside /usr/share/kbd/consolefonts to see available fonts), then add consolefont to the mkinitcpio hooks in /etc/mkinitcpio.conf.

Drawing the shapes

Looking deeper into mkinitcpio hooks, I discovered that creating your own hook is actually pretty straight-forward, so I got to work writing one to draw out the console's display immediately before the password prompt. I simply had to write a hook to print whatever I wanted and add it to my /etc/mkinitcpio.conf.

For a simple first-attempt interface, I decided on the message "Welcome" drawn in big letters in my favourite font, tamzen, with an input box drawn underneath for when I'm asked to unlock the root partition. I figured I could draw the big word by making "pixels" from symbols.

I got the template by screenshotting my normal xterm (also using the tamzen font) and scaling it up:

The word 'Welcome' in tamzen font

Following this, I typed out a bunch of echo commands into my new hook that would each print a single line of the console, and would together spell "Welcome" in big letters. For this, I used pairs of block characters (i.e. "██") as pixels to draw the word pixel-by-pixel. The input box is just an empty rectangle frame drawn using these pixels underneath the Welcome message. Using ANSI escape codes I could move the cursor position into the input box after printing the display, e.g. printing "\x1b[32;96H" will place the cursor in the 32nd column, 96th row.


Next, I needed to define the colours that all the elements should have: the background, "Welcome", and the input box. My first instinct was to simply use more escape codes to set the "current" terminal colour, which would look something like this:

# This sets the current foreground to colour 0
echo -en "\x1b[38;5;${COLOUR}m"

# While this sets the current background to colour 5
echo -en "\x1b[48;5;${COLOUR}m"

I added lines like these in places in the pixel-drawing echo lines where the foreground or background colour was to be changed, and it worked quite well. However, the problem with this is that the colours that the TTY uses are restricted to default values predefined by the linux framebuffer (which are not pretty).

A quick search on changing the TTY's colours lead me to this askubuntu question describing how to change the colours that correspond to the consoles's 0-15 colour definitions. Based on these lines (more escape codes!) I cobbled together some logic at the top of my hook to redefine the TTY's colour palette using the same hexadecimal colour values I use for my X desktop, and stripped out the previous escape codes I was using.

Great! The colours were being set!

Right as I was planning to put the colour logic into a small package, I came across Evan Purkhiser's mkinitcpio-colors, which is a more polished version of what I would have made to set the TTY colours at boot using variables defined in /etc/vconsole.conf. I installed this from the AUR so that my welcome message would use my usual terminal colour scheme.

Finishing up

The output of fsck is printed out after entering the password. Apparently this can be silenced, but I preferred to simply reposition the cursor into a second line of the inpux box so it can be printed there. For this I added a second hook after the encrypt hook.

This is the final version:

Looking great, huh!

I've saved the two mkinitcpio hooks in a git project here, which installed alongside mkinitcpio-colors should be enough to recreate this bootup. I haven't tested it with any other font sizes though, so the thought of trying it with a different size worries me.

If you have any thoughts, comments, criticisms, feel free to reach out on mastodon or by email ʕ•ᴥ•ʔ