buffyboard(1)

📦
version 3.5.1 · 4 versions
, in ubuntu stonking

💖 BUFFYBOARD 💖

okay so bestie, we're reading the buffyboard(1) page together, and honestly? it's giving main character energy. it's a General Commands Manual entry, and it's about a touch-enabled framebuffer keyboard that is (and I cannot stress this enough) not only for vampire slayers. slay. 🧛♀️✨

✨ NAME ✨

BUFFYBOARD — Touch-enabled framebuffer keyboard (not only) for vampire slayers. 💅

🌸 SYNOPSIS 🌸

buffyboard [OPTION]

literally that's it. one command, zero drama (well, mostly). 🫶

🦋 DESCRIPTION 🦋

Buffyboard is a touch-enabled on-screen keyboard that runs on the Linux framebuffer. Its primary intended purpose is vampire hunting 🧛♂️🔥, but lowkey you can also just use it as a general purpose keyboard. both are valid. both are iconic.

Buffyboard uses LVGL for input processing and rendering. Key events get forwarded directly to the kernel via a uinput device. and here's the thing bestie, listen up 👂: since that thing emulates a hardware keyboard, the terminal keymap must match buffyboard's layout — otherwise your on-screen keys might not produce the correct result. no cap. 😭

👑 OPTIONS 👑

💜 Optional 💜

  • -C, --config-override — Path to a config override file. can be supplied multiple times, she's flexible like that. ✨ Config files are merged in this exact order:
    • /usr/share/buffyboard/buffyboard.conf
    • /usr/share/buffyboard/buffyboard.conf.d/* (alphabetically)
    • /etc/buffyboard.conf
    • /etc/buffyboard.conf.d/* (alphabetically)
    • Override files (in supplied order)
  • -g, --geometry=NxM[@X,Y] — Force a display size of N horizontal times M vertical pixels, offset horizontally by X pixels and vertically by Y pixels. 📐
  • -d, --dpi=N — Override the display's DPI value. 🔍
  • -r, --rotate=[0-3] — Rotate the UI to the given orientation. the values match the ones the kernel provides in /sys/class/graphics/fbcon/rotate:
    • 0 - normal orientation (0 degree)
    • 1 - clockwise orientation (90 degrees)
    • 2 - upside down orientation (180 degrees)
    • 3 - counterclockwise orientation (270 degrees)
  • -h, --help — Print this message and exit. the classic. 🎀
  • -v, --verbose — Enable more detailed logging output on STDERR. she's yapping (affectionate) 🗣️
  • -V, --version — Print the unl0kr version and exit. yes bestie, it says unl0kr, I'm not making this up, I'm just the messenger 💀

🌈 NOTES 🌈

Some terminal commands, like clear or setfont, can erase the keyboard or break the layout of the terminal. NOT the vibe. 🙈 In that case you should send a signal to Buffyboard or switch to another terminal to update the screen:

setfont solar24x32;/usr/bin/kill -s SIGUSR1 buffyboard
setfont solar24x32;chvt $((`fgconsole`+1));chvt $((`fgconsole`-1))
copy these character for character, bestie, fgconsole backticks and all. 💅

🍓 EXAMPLES 🍓

Execute Buffyboard using the default config:

buffyboard

that's the whole example. she's simple, she's effective, she ate. 🔥

⭐ SEE ALSO ⭐

buffyboard.conf(5)

🎀 AUTHORS 🎀

Undef <debian@undef.tools>

and that's the tea, bestie 🫶 this page is from the buffyboard source, version-dated 2026-06-20, and it lives in section buffyboard(1) of the General Commands Manual. go hunt some vampires (or just type stuff, both slay). 🧛♀️💖✨

📦 where this page comes from