scorpiox-renderimage Core Tool

Render images to terminal using ANSI escape codes. Displays PNG, JPEG, BMP, and other common image formats directly in your terminal as colored block characters, enabling image previews without leaving the command line.

🐧 Linux x64 🐧 Linux ARM64 🍎 macOS ARM64 🪟 Windows x64

Flags & Options

This tool accepts no flags — simply pass the image file path as an argument.

scorpiox-renderimage <image-path>

Usage Examples

Basic — render a PNG image
$ scorpiox-renderimage logo.png
Render a JPEG photo
$ scorpiox-renderimage photo.jpg
# The image is rendered as colored Unicode block characters
# using ANSI 24-bit true-color escape sequences
Preview a downloaded screenshot
$ curl -sO https://example.com/screenshot.png
$ scorpiox-renderimage screenshot.png
Use in a script to visualize build artifacts
#!/bin/bash
# render-artifacts.sh — preview generated charts after a build
for img in output/charts/*.png; do
    echo "=== $img ==="
    scorpiox-renderimage "$img"
    echo ""
done
Quick icon check in CI/CD
$ scorpiox-renderimage assets/favicon.png
# Useful for verifying image assets in headless CI environments
# without needing a graphical display server
Render a BMP file
$ scorpiox-renderimage diagram.bmp
# Supports common raster formats: PNG, JPEG, BMP

Source & Build Info

Source File
scorpiox/scorpiox-renderimage.c
Lines of Code
230
Dependencies
libsxutil

Related Tools