Skip to main content

​
ASCII art settings

Pomo displays the countdown timer using large ASCII art fonts. You can customize the font style, color, or disable it entirely.
​
asciiArt.enabled
boolean
default:"true"
Enable or disable ASCII art timer displayWhen disabled, shows a simple text-based timer
​
asciiArt.font
string
default:"mono12"
Font style for the ASCII art timerAvailable fonts:
  • mono12 - Blocky monospace font (default)
  • rebel - Bold font with gradient shading
  • ansi - Clean, simple ANSI font
  • ansiShadow - ANSI font with box-drawing characters
​
asciiArt.color
string
default:"#5A56E0"
Color of the ASCII art timer in hex formatUse 6-digit hex color codes like #5A56E0 or #FF4C4C

​
Basic example

pomo.yaml
asciiArt:
  enabled: true
  font: mono12
  color: "#5A56E0"

​
Available fonts

Pomo includes four built-in ASCII art fonts, each with a unique style.
Blocky monospace font with clean, readable characters.
asciiArt:
  font: mono12
  color: "#5A56E0"
Best for: Default choice, good readability and terminal compatibility
Bold font with gradient shading using extended ASCII characters.
asciiArt:
  font: rebel
  color: "#8860FF"
Best for: Eye-catching display, modern terminals with good Unicode support
Clean, simple ANSI font with block characters.
asciiArt:
  font: ansi
  color: "#F25D94"
Best for: Minimalist look, maximum compatibility
ANSI font using box-drawing characters for a shadowed effect.
asciiArt:
  font: ansiShadow
  color: "#4A9EFF"
Best for: Stylish appearance with good terminal support

​
Color customization

The timer color uses 6-digit hex color codes. Here are some examples: 
asciiArt:
  color: "#5A56E0"
Color codes must be in 6-digit hex format with a # prefix. Invalid colors will fall back to the terminal’s default color.

​
Color format rules

  • Valid: #5A56E0, #FF4C4C, #198754
  • Invalid: #F00 (too short), 5A56E0 (missing #), purple (named colors not supported)

​
Disabling ASCII art

If you prefer a minimal display, you can disable ASCII art entirely:
pomo.yaml
asciiArt:
  enabled: false
When disabled, Pomo shows a simple text-based timer instead of large ASCII art.
Disabling ASCII art can be useful for smaller terminal windows or when running Pomo in the background.

​
Font examples

Here’s how different fonts look with various colors: 
asciiArt:
  enabled: true
  font: mono12
  color: "#5A56E0"

​
Terminal compatibility

All fonts work in most modern terminals. However:
  • mono12 and ansi - Maximum compatibility, use basic block characters
  • rebel - Requires Unicode support for gradient characters (▒, ░)
  • ansiShadow - Requires box-drawing character support (╔, ═, ║)
If characters don’t display correctly, your terminal may not support the required Unicode characters. Try switching to mono12 or ansi for better compatibility.

Build docs developers (and LLMs) love

Get started for freeTalk to us