Skip to content
Tutorial Reference

How to Create a Gradient Color Effect in Console Output in Batch Script

Learn how to generate smooth color gradients in Windows Batch scripts using ANSI 256-color codes for eye-catching text effects like splash screens and branding.

Standard Batch text comes in one solid color. While useful, a Gradient Effect, where text changes color smoothly from one hue to another (e.g., from Dark Blue to Bright Cyan), creates a stunning, high-end aesthetic. This is perfect for splash screens, branding logos, or major headers that need to stand out immediately.

In this guide, we will demonstrate how to create gradients using ANSI 256-color codes and a loop.

The Theory: ANSI 256-Color Palette

Traditional ANSI colors are limited to 16. However, modern Windows terminals support the 256-color palette.

  • The code format is: ESC[38;5;Nm where N is a number from 0 to 255.
  • Blue gradients are roughly in the range of 20-27.
  • Green gradients are roughly in the range of 28-46.
  • Grey/White gradients are in the range of 232-255.

Method 1: The Character-by-Character Gradient

To create a gradient across a word, we must print each character using a slightly different color code.

Implementation Script

@echo off
setlocal enabledelayedexpansion

:: 1. Capture ESC character
for /f %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"

set "word=INITIALIZING SYSTEM"
set "startColor=21"

:: 2. Calculate string length
set "tempWord=!word!"
set "wordLen=0"
:countLoop
if defined tempWord (
    set "tempWord=!tempWord:~1!"
    set /a "wordLen+=1"
    goto :countLoop
)

:: 3. Enable bold for vibrant colors
echo.
<nul set /p "=!ESC![1m"

:: 4. Loop through each character
set /a "lastIndex=wordLen - 1"
for /L %%i in (0,1,!lastIndex!) do (
    set /a "color=startColor + %%i"
    set "char=!word:~%%i,1!"
    <nul set /p "=!ESC![38;5;!color!m!char!"
)

:: 5. Reset formatting and finish
echo !ESC![0m
echo.
pause
exit /b 0

Method 2: The Multi-Line Logo Gradient

If you have a large multi-line logo, you can shift the color for each line to create a vertical gradient.

@echo off
setlocal enabledelayedexpansion

:: Capture ESC character
for /f %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"

:: Define logo lines
set "line1=   ______  "
set "line2=  / ____ \ "
set "line3= / / __ \ \"
set "line4= \ \__/ / /"
set "line5=  \____/_/ "

:: Starting color in the red range
set "c=160"

echo.
echo !ESC![38;5;!c!m!line1!!ESC![0m
set /a "c+=1"
echo !ESC![38;5;!c!m!line2!!ESC![0m
set /a "c+=1"
echo !ESC![38;5;!c!m!line3!!ESC![0m
set /a "c+=1"
echo !ESC![38;5;!c!m!line4!!ESC![0m
set /a "c+=1"
echo !ESC![38;5;!c!m!line5!!ESC![0m
echo.

pause
exit /b 0

Selecting Your Gradient Range

You can find "ANSI 256 Color Charts" online. Common ranges for gradients:

  • Red to Orange: 160, 166, 172, 178, 184.
  • Blue to Cyan: 19, 20, 21, 26, 27, 33, 39.
  • Forest to Lime: 22, 28, 34, 40, 46.
  • Grayscale: 232 (Black) to 255 (White).

Performance Considerations

  1. Speed: Printing a long sentence character-by-character with individual ANSI codes is much slower than a standard echo. For long texts, the user might see the gradient "crawl" across the screen.
  2. Compatibility: 256-color support is a feature of Windows 10 version 1511 and later. Older versions will display raw escape sequences as literal text. Use this effect only if you can guarantee a modern Windows environment.

Best Practices

  1. Use Bold: Gradients look significantly better if you enable Bold (ESC[1m) at the start. It makes the colors more vibrant and saturated.
  2. Contrast: Always ensure your gradient ends on a color that is still readable against your terminal background (usually black).
  3. Minimalism: Use gradients only for the "Hero" text of your script (the main title). Using them for standard log entries is visually overwhelming and reduces readability.
  4. Reset Per Line: In multi-line output, reset the color at the end of each line rather than only once at the very end. This prevents color bleed if the script is interrupted or if other processes write to the console.
  5. Validate Color Range: Ensure that startColor + textLength does not exceed 255 or cross into an unrelated color region of the palette, which would break the gradient illusion.

Conclusion

Gradient effects represent the cutting edge of visual design in the command line. By leveraging the ANSI 256-color palette and simple incrementing loops, you can create interfaces that feel alive, modern, and high-end. This level of aesthetic polish makes your Batch tools stand out as premium, professional solutions in any software ecosystem.

Navigation