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
-
Access Terminal Settings:
- In the top-right corner of the Terminal window, click the three-dot menu (
⋮). - Select Settings from the drop-down menu.
- In the top-right corner of the Terminal window, click the three-dot menu (

Image 1: Accessing Terminal Settings via the three-dot menu.
-
Navigate to Display Resolution:
- In the left sidebar of the Settings window, select Advanced.
- Under the Advanced section, click on Display resolution.
-
Select the Recommended Density:
- In the dialogue box, choose Half (Recommended).
- Click OK to confirm and apply the changes.
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
CLI Locales Configuration
sudo dpkg-reconfigure locales
Technical Note on CLI vs GUI Scope:
Generating system locales withdpkg-reconfigure localessets 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:
-
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.
- Scroll down the list under Locales to be generated to find
-
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.
- On the Default locale for the system environment: screen, select
Compilation Output:
Generating locales (this might take a while)...
en_GB.UTF-8... done
Generation complete.
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
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
Environment Verification:
Verify system locale environment variables and the active Xwayland keymap:
# Verify CLI environment
locale
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=
(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
WARNING: Running setxkbmap against an Xwayland server
rules: evdev
model: pc105
layout: gb
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
Verification:
fc-list | grep -i "Roboto Mono"
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
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
Launch the browser cleanly by executing:
chrome
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.
5.2. Window Management and Session Input Controls
The Googlebook OS Terminal display window includes controls for both window layout and container session interaction:
-
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.
-
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.
-
Keyboard Layout Verification:
- Pressing
Shift + 3in Chrome's address bar displays£(Pound sterling), confirming that the UK ISO keymap is functioning properly.
- Pressing





Top comments (0)