Framebuffer mode provides direct rendering to /dev/fb0 on Linux console, enabling pixel-perfect DOS-like display with classic text modes.

Note: This feature is Linux-only and requires the framebuffer-backend feature at compile time.

• Linux operating system
• Physical console (TTY1-6), not terminal emulators or SSH
• Access to /dev/fb0 (root or member of video group)
• Compiled with --features framebuffer-backend

# Build with framebuffer support
cargo build --release --features framebuffer-backend

# Run in framebuffer mode (may require sudo)
sudo ./target/release/term39 -f --fb-mode=80x25

Use the interactive setup wizard to configure framebuffer mode:

term39 --fb-setup

The wizard allows you to:

• Select text mode
• Choose pixel scale factor
• Select console font
• Configure mouse settings

Settings are saved to ~/.config/term39/fb.toml.

# Enable framebuffer mode
term39 -f
term39 --framebuffer

# Specify text mode
term39 -f --fb-mode=80x50

# Set pixel scale (1-4 or auto)
term39 -f --fb-scale=2

# Specify font
term39 -f --fb-font=Unifont-APL8x16

# List available fonts
term39 --fb-list-fonts

# Use specific font
term39 -f --fb-font=Uni3-Terminus16

# Specify mouse device
term39 -f --mouse-device=/dev/input/event2

# Adjust sensitivity (0.1-5.0)
term39 -f --mouse-sensitivity=1.5

# Swap mouse buttons
term39 -f --swap-mouse-buttons

# Invert axes
term39 -f --invert-mouse-x
term39 -f --invert-mouse-y

# Add to video group (for /dev/fb0)
sudo usermod -aG video $USER

# Add to input group (for mouse devices)
sudo usermod -aG input $USER

# Log out and back in for changes to take effect

sudo term39 -f --fb-mode=80x25

Ensure you're on a physical console (Ctrl+Alt+F1 through F6), not a terminal emulator.

Add your user to the video group:

sudo usermod -aG video $USER

Then log out and back in.

1. Check if mouse device exists:

   ls -la /dev/input/mice /dev/input/event*

2. Add user to input group:

   sudo usermod -aG input $USER

3. Try specifying the device explicitly:

   term39 -f --mouse-device=/dev/input/event2

Use --fb-list-fonts to see available fonts and their dimensions, then select one matching your desired text mode.

Install fonts on Debian/Ubuntu:

sudo apt install kbd unifont

Framebuffer settings are saved to ~/.config/term39/fb.toml:

[display]
mode = "80x25"
scale = "auto"

[font]
name = "Unifont-APL8x16"

[mouse]
device = "/dev/input/mice"
swap_buttons = false
invert_x = false
invert_y = false

• Installation
• Configuration
• Mouse Controls