omarchy_large_font_setup.md

Large Font Terminal Setup for Omarchy Users

Problem Statement

The default Alacritty terminal font size in Omarchy can be too small for comfortable reading during extended coding sessions. However, simply increasing the global font size breaks TUI applications like btop, lazydocker, and other monitoring tools that rely on compact layouts.

Solution Overview

This guide implements a dual-configuration approach that gives you the best of both worlds:

• Large font terminals (size 14) for comfortable regular terminal work
• Small font terminals (size 9) for TUI applications that need compact layouts
• Seamless integration with Omarchy's existing hotkeys and workflows

Key Benefits

✅ Super+Enter launches large, comfortable font terminals ✅ Super+T (btop) and Super+D (lazydocker) keep compact fonts ✅ Preserves all Omarchy terminal functionality (working directory, themes) ✅ No conflicts with existing TUI workflows ✅ Easy manual access via aliases (tl, term-large)

---

Implementation Guide

Prerequisites

• Omarchy setup with Alacritty as the default terminal
• Access to ~/.config/alacritty/ and ~/.config/hypr/ directories

---

Step-by-Step Setup

Step 1: Create Large Font Configuration

Create a new Alacritty configuration file specifically for large font terminals:

# Create the large font config file
touch ~/.config/alacritty/large-font.toml

Step 2: Set Up Terminal Launch Scripts

Create a convenient script for launching large font terminals:

# Create the script
touch ~/.local/bin/terminal-large
chmod +x ~/.local/bin/terminal-large

Step 3: Add Bash Aliases

Add convenient aliases to your .bashrc for easy access:

# Add to the end of ~/.bashrc
echo "" >> ~/.bashrc
echo "# Terminal aliases for different font sizes" >> ~/.bashrc
echo "alias term-large='alacritty --config-file ~/.config/alacritty/large-font.toml'" >> ~/.bashrc
echo "alias tl='alacritty --config-file ~/.config/alacritty/large-font.toml'" >> ~/.bashrc

Step 4: Update Hyprland Keybinding

Modify your Hyprland bindings to use the large font terminal for Super+Enter:

1. Open ~/.config/hypr/bindings.conf
2. Find the line that starts with bindd = SUPER, return
3. Update it to use the large font configuration

Step 5: Reload Configurations

Apply all changes:

# Reload bash aliases
source ~/.bashrc

# Reload Hyprland configuration
hyprctl reload

---

Complete Configuration Files

Large Font Alacritty Configuration

Create ~/.config/alacritty/large-font.toml with this content:

general.import = [ "~/.config/omarchy/current/theme/alacritty.toml" ]

[env]
TERM = "xterm-256color"

[font]
normal = { family = "CaskaydiaMono Nerd Font", style = "Regular" }
bold = { family = "CaskaydiaMono Nerd Font", style = "Bold" }
italic = { family = "CaskaydiaMono Nerd Font", style = "Italic" }
size = 14

[window]
padding.x = 14
padding.y = 14
decorations = "None"

[keyboard]
bindings = [
{ key = "F11", action = "ToggleFullscreen" }
]

Terminal Launch Script

Create ~/.local/bin/terminal-large with this content:

#!/bin/bash
# Launch Alacritty with large font
exec alacritty --config-file ~/.config/alacritty/large-font.toml "$@"

Hyprland Binding Update

In ~/.config/hypr/bindings.conf, find this line:

bindd = SUPER, return, Terminal, exec, $terminal --working-directory=$(omarchy-cmd-terminal-cwd)

Replace it with:

bindd = SUPER, return, Terminal, exec, alacritty --config-file ~/.config/alacritty/large-font.toml --working-directory=$(omarchy-cmd-terminal-cwd)

---

Usage Examples

Hotkey Usage

• Super+Enter: Launch large font terminal (size 14) in current working directory
• Super+T: Launch btop with small font (size 9) - perfect for monitoring
• Super+D: Launch lazydocker with small font (size 9) - compact interface

Command Line Usage

# Quick large font terminal
tl

# Full alias
term-large

# Script (if you prefer)
terminal-large

# Regular small font terminal (unchanged)
alacritty

Font Size Comparison

• Small font (size 9): Perfect for TUI applications, more content fits on screen
• Large font (size 14): Comfortable for reading code, documentation, and extended terminal sessions

---

Troubleshooting

Common Issues

Q: Super+Enter doesn't launch large font terminal

• Ensure you reloaded Hyprland: hyprctl reload
• Check that the binding was updated correctly in ~/.config/hypr/bindings.conf

Q: Aliases don't work (tl command not found)

• Reload your bash configuration: source ~/.bashrc
• Open a new terminal session
• Verify aliases were added to your .bashrc

Q: Large font config not loading

• Verify the file exists: ls ~/.config/alacritty/large-font.toml
• Check file permissions: chmod 644 ~/.config/alacritty/large-font.toml
• Test manually: alacritty --config-file ~/.config/alacritty/large-font.toml

Q: Theme not loading in large font terminal

• Ensure the first line of large-font.toml imports the theme:

  general.import = [ "~/.config/omarchy/current/theme/alacritty.toml" ]

Testing Your Setup

Run these commands to verify everything works:

# Test aliases
tl
term-large

# Test script
terminal-large

# Test hotkey
# Press Super+Enter and verify large font

# Test TUI applications still work
# Press Super+T for btop
# Press Super+D for lazydocker

---

Customization

Adjusting Font Sizes

Edit ~/.config/alacritty/large-font.toml and modify the size value:

[font]
size = 16  # Even larger
# or
size = 12  # Slightly smaller

Different Font Families

You can also change the font family in the large font config:

[font]
normal = { family = "JetBrains Mono", style = "Regular" }
bold = { family = "JetBrains Mono", style = "Bold" }
italic = { family = "JetBrains Mono", style = "Italic" }

---

Conclusion

This setup gives you the perfect balance between comfortable reading and functional TUI applications.