DEV Community

Cover image for Googlebook Linux Terminal: Essential Setup (Display, Fonts, and Chrome)
Igor Jagec
Igor Jagec

Posted on Edited on Originally published at dev.to AI-assisted

Googlebook Linux Terminal: Essential Setup (Display, Fonts, and Chrome)

Display, Fonts, and Chrome

1. Prerequisites: Display Scaling via Host Settings

Before installing packages or launching graphical applications, configure virtual display scaling directly in your host hypervisor settings rather than inside the Debian container.

Managing scaling within the container by editing weston.ini or overriding display outputs is unreliable. The virtual display driver frequently renames outputs across sessions (such as switching from Virtual-1 to Virtual-2), which breaks static configurations and resets the display to an unscaled state.

Adjusting display density directly in Googlebook Terminal settings scales the entire virtual display natively without extra configuration files.

Step-by-Step Configuration

  1. Access Terminal Settings:
    • In the top-right corner of the Terminal window, click the three-dot menu (⋮).
    • Select Settings from the drop-down menu.

Accessing Terminal Settings via the three-dot menu
Image 1: Accessing Terminal Settings via the three-dot menu.

  1. Navigate to Display Resolution:

    • In the left sidebar of the Settings window, select Advanced.
    • Under the Advanced section, click on Display resolution.
  2. Select the Recommended Density:

    • In the dialogue box, choose Half (Recommended).
    • Click OK to confirm and apply the changes.

Googlebook Terminal settings menu showing advanced display resolution option

Technical Note on Output Scaling:
Choosing Half creates a 2× scaled display buffer for high-DPI screens without requiring extra display flags. Once configured, proceed to the package and font setup below.


2. System Update, Locales & Core Google Fonts

Minimal container images use generic fallback fonts (like Liberation or DejaVu) and often lack UTF-8 locales. Google web services and modern browsers rely on the Roboto font family for proper display layout.

Update your system and install the required utility packages, locales, and official Debian font packages:

# Update package indices and upgrade base system
sudo apt update && sudo apt upgrade -y

# Install foundational packages, locale generation tools, and Google fonts
sudo apt install -y wget curl ca-certificates gnupg fontconfig locales \
fonts-roboto fonts-roboto-slab fonts-noto-color-emoji
Enter fullscreen mode Exit fullscreen mode

CLI Locales Configuration

sudo dpkg-reconfigure locales
Enter fullscreen mode Exit fullscreen mode

Technical Note on CLI vs GUI Scope:
Generating system locales with dpkg-reconfigure locales sets environment variables (LANG, LC_*), text encoding, and formatting rules for terminal sessions. This does not change physical keyboard key mappings in graphical apps under Xwayland, which must be configured separately in your session startup configuration.

TUI Navigation Controls:

  • Up / Down Arrows: Move up or down through the list.
  • Spacebar: Select or deselect items ([*]).
  • Tab: Switch focus between the list and the buttons (<Ok> / <Cancel>).
  • Enter: Confirm your selection and continue.

Step-by-Step Procedure:

  1. Select Target Locale:
    • Scroll down the list under Locales to be generated to find en_GB.UTF-8 UTF-8.
    • Press Spacebar to mark the checkbox ([*] en_GB.UTF-8 UTF-8).
    • Press Tab to highlight <Ok>, then press Enter.

Debian dpkg-reconfigure interface selecting UTF-8 locale

  1. Select Default Environment Locale:
    • On the Default locale for the system environment: screen, select en_GB.UTF-8.
    • Press Tab to highlight <Ok>, then press Enter to compile.

Google Chrome running on Googlebook with terminal display session controls

Compilation Output:

Generating locales (this might take a while)...
en_GB.UTF-8... done
Generation complete.
Enter fullscreen mode Exit fullscreen mode

Reboot System:

Rebooting the system is necessary for the newly generated locales to take full effect across all system processes and environment variables:

sudo reboot
Enter fullscreen mode Exit fullscreen mode

Keyboard Layout Persistence (Xwayland / UK ISO)

Locale settings only cover text encoding, so Xwayland defaults to a standard US keyboard layout rather than inheriting keymap settings from the Googlebook host.

To use the UK (ISO) layout across all graphical apps without creating errors in command-line sessions, add this execution check to ~/.bashrc:

# Set UK keyboard layout for active Xwayland sessions
cat << 'EOF' >> ~/.bashrc

# Ensure UK keyboard mapping in Xwayland
if [ -n "$DISPLAY" ]; then
    setxkbmap gb >/dev/null 2>&1
fi
EOF

source ~/.bashrc
Enter fullscreen mode Exit fullscreen mode

Environment Verification:

Verify system locale environment variables and the active Xwayland keymap:

# Verify CLI environment
locale
Enter fullscreen mode Exit fullscreen mode
LANG=en_GB.UTF-8
LANGUAGE=
LC_CTYPE="en_GB.UTF-8"
LC_NUMERIC="en_GB.UTF-8"
LC_TIME="en_GB.UTF-8"
LC_COLLATE="en_GB.UTF-8"
LC_MONETARY="en_GB.UTF-8"
LC_MESSAGES="en_GB.UTF-8"
LC_PAPER="en_GB.UTF-8"
LC_NAME="en_GB.UTF-8"
LC_ADDRESS="en_GB.UTF-8"
LC_TELEPHONE="en_GB.UTF-8"
LC_MEASUREMENT="en_GB.UTF-8"
LC_IDENTIFICATION="en_GB.UTF-8"
LC_ALL=
Enter fullscreen mode Exit fullscreen mode

(Note: It is expected for LC_ALL and LANGUAGE variables to remain empty by default unless explicit overrides are required).

# Verify active Xwayland layout
setxkbmap -query
Enter fullscreen mode Exit fullscreen mode
WARNING: Running setxkbmap against an Xwayland server
rules:      evdev
model:      pc105
layout:     gb
Enter fullscreen mode Exit fullscreen mode

3. Manual Installation of Roboto Mono

The Debian fonts-roboto package includes standard sans-serif fonts but omits Roboto Mono. Download the TrueType font files directly from Google Fonts on GitHub and rebuild the system font cache:

# Prepare local fonts directory
mkdir -p ~/.local/share/fonts/roboto-mono

# Fetch variable TrueType fonts from the official repository
curl -fSL "https://raw.githubusercontent.com/google/fonts/main/ofl/robotomono/RobotoMono%5Bwght%5D.ttf" \
-o ~/.local/share/fonts/roboto-mono/RobotoMono-Regular.ttf

curl -fSL "https://raw.githubusercontent.com/google/fonts/main/ofl/robotomono/RobotoMono-Italic%5Bwght%5D.ttf" \
-o ~/.local/share/fonts/roboto-mono/RobotoMono-Italic.ttf

# Refresh font cache
fc-cache -f
Enter fullscreen mode Exit fullscreen mode

Verification:

fc-list | grep -i "Roboto Mono"
Enter fullscreen mode Exit fullscreen mode

4. Google Chrome Installation (Official DEB822 Repository)

To enable automatic updates via apt instead of manually downloading and managing standalone .deb files, set up Google's official APT repository using the modern DEB822 format:

# 1. Create keyrings directory and import Google's official signing key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor --yes -o /etc/apt/keyrings/google-chrome.gpg
sudo chmod a+r /etc/apt/keyrings/google-chrome.gpg

# 2. Add DEB822 source file
cat << 'EOF' | sudo tee /etc/apt/sources.list.d/google-chrome.sources
Types: deb
URIs: https://dl.google.com/linux/chrome/deb/
Suites: stable
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/google-chrome.gpg
EOF

# 3. Update indices and install stable Chrome
sudo apt update
sudo apt install -y google-chrome-stable
Enter fullscreen mode Exit fullscreen mode

5. Headless D-Bus Suppression & Execution Alias (Optional)

In container environments without a full desktop manager, launching Chrome directly prints persistent D-Bus errors (such as Failed to connect to the bus or NameHasOwner).

To run Chrome quietly in the background without cluttering the terminal, create an execution alias:

cat << 'EOF' >> ~/.bash_aliases
alias chrome='google-chrome >/dev/null 2>&1 &'
EOF

source ~/.bashrc
Enter fullscreen mode Exit fullscreen mode

Launch the browser cleanly by executing:

chrome
Enter fullscreen mode Exit fullscreen mode

5.1. Launching the Browser

Running chrome starts the process in the background and returns a background job ID (such as 475).

The browser window opens in the display layer rather than inside the terminal text area. To view Chrome, click the Display icon (monitor symbol) in the upper-right corner of the terminal window bar.

Debian dpkg-reconfigure interface selecting default system locale

5.2. Window Management and Session Input Controls

The Googlebook OS Terminal display window includes controls for both window layout and container session interaction:

  1. Container Input Mode Toolbar (Top Right of Title Bar):

    • Pan / Touch Mode (Hand Icon): Enables touch scrolling and panning across the virtual display.
    • Virtual Keyboard (Keyboard Icon): Opens or closes the on-screen software keyboard.
    • Pointer Capture Mode (Mouse Icon): Locks or releases mouse cursor capture within the active session.
    • Close Session (X Icon): Ends and closes the graphical display window.
  2. Host Window Management (Maximise / Snap Controls):

    • Hovering over the window control cluster reveals Googlebook OS window layout options (Maximise, Resize, and split-screen snapping).
    • Maximising the window expands the virtual display canvas to fill your full screen.
  3. Keyboard Layout Verification:

    • Pressing Shift + 3 in Chrome's address bar displays £ (Pound sterling), confirming that the UK ISO keymap is functioning properly.

Googlebook terminal displaying background chrome execution and display icon

Top comments (0)