Skip to main content
The -list-fonts command displays all monospace fonts available on your system that can be used with Termy.

​
Usage

termy-cli -list-fonts

​
What It Does

This command queries your system’s font library and returns a sorted list of monospace fonts suitable for terminal use.

​
Platform-Specific Behavior

Uses Core Text APIs to enumerate all installed font families with monospace characteristics.
termy-cli -list-fonts
Returns all fonts from:
  • System fonts (/System/Library/Fonts/)
  • User fonts (~/Library/Fonts/)
  • Third-party fonts

​
Example Output

Anonymous Pro
Cascadia Code
Cascadia Mono
Commit Mono
Courier New
DejaVu Sans Mono
Fira Code
Fira Mono
Geist Mono
Hack
IBM Plex Mono
Inconsolata
JetBrains Mono
Menlo
Messina Sans Mono
Monaco
Roboto Mono
SF Mono
Source Code Pro
Ubuntu Mono

​
Use Cases

​
Finding a Specific Font

Combine with grep to search for fonts: 
termy-cli -list-fonts | grep -i "fira"

​
Checking Font Availability

Verify a font is installed before using it in your config: 
if termy-cli -list-fonts | grep -q "JetBrains Mono"; then
  echo "JetBrains Mono is installed"
else
  echo "JetBrains Mono not found"
fi

​
Saving Font List

Export the list for reference: 
termy-cli -list-fonts > available-fonts.txt

​
Configuring Font in Termy

Once you’ve identified a font, set it in your configuration: 
termy-cli -edit-config
The font name must match exactly as it appears in the -list-fonts output. Font names are case-sensitive.

​
Font Requirements

Termy displays monospace fonts that meet these criteria:
  • Fixed width: Every character has the same width
  • Installed: Present in your system font directories
  • Accessible: Readable by the current user
Proportional (variable-width) fonts are not suitable for terminal use and won’t appear in this list.
Here are some widely-used monospace fonts for terminals:
FontCharacteristicsBest For
JetBrains MonoLigatures, increased heightCoding, long sessions
Fira CodeProgramming ligaturesCode readability
SF Mono (macOS)Clean, modernmacOS users
Cascadia CodeMicrosoft’s modern fontWindows users
HackHigh legibilitySmall font sizes
Source Code ProAdobe’s open-source fontProfessional coding
Menlo (macOS)Default macOS terminal fontmacOS defaults
DejaVu Sans MonoUnicode coverageMulti-language support

​
Troubleshooting

​
No Fonts Listed

Install fontconfig:
# Ubuntu/Debian
sudo apt install fontconfig

# Fedora
sudo dnf install fontconfig

# Arch
sudo pacman -S fontconfig
Refresh your font cache:macOS: Restart Font Book or restart your systemLinux:
fc-cache -fv
Windows: Restart your system

​
Font Appears but Doesn’t Work in Termy

  1. Verify exact font name (case-sensitive): 
    termy-cli -list-fonts | grep -i "yourfont"
  2. Check configuration syntax: 
    termy-cli -validate-config
  3. Ensure the font is truly monospace

Show Config

View your current font setting

Edit Config

Update your font configuration

Interactive TUI

Browse fonts visually

Font Configuration

Font configuration reference

Build docs developers (and LLMs) love

Get started for freeTalk to us