scorpiox-renderimage🔨 build

Render images directly in the terminal using ANSI escape sequences and Sixel graphics protocols.

Linux x64 Linux ARM64 macOS ARM64 Windows x64

📖 Description

scorpiox-renderimage converts image files (PNG, JPEG, BMP, GIF) into terminal-compatible output using ANSI 24-bit color escape sequences or Sixel graphics. It auto-detects terminal capabilities and selects the best rendering protocol. Ideal for previewing images in SSH sessions, CI logs, and headless environments without a GUI.

⚙️ Flags & Options (0)

This tool has no configurable flags. It reads an image path as a positional argument.

💡 Usage Examples

Render a PNG image in the terminal

# Display a PNG image using auto-detected protocol

$ scorpiox-renderimage screenshot.png

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄

█                      █

█  [image rendered]    █

▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

Preview images over SSH

# View a remote image without transferring the file

$ ssh devbox "scorpiox-renderimage /var/captures/error.png"

# Pipe output from another tool

$ scorpiox-screenshot && scorpiox-renderimage screenshot_0.bmp

Render different image formats

# JPEG photo

$ scorpiox-renderimage photo.jpg

# BMP from screenshot capture

$ scorpiox-renderimage capture.bmp

# GIF (renders first frame)

$ scorpiox-renderimage animation.gif

CI/CD pipeline image verification

# Verify a generated chart in CI logs

$ python3 generate_chart.py --output report.png

$ scorpiox-renderimage report.png

# Quick visual diff — render before & after screenshots

$ echo "=== BEFORE ===" && scorpiox-renderimage before.png

$ echo "=== AFTER ===" && scorpiox-renderimage after.png

Combine with scorpiox-bmp2png

# Capture, convert, and preview in one pipeline

$ scorpiox-screenshot

$ scorpiox-bmp2png screenshot_0.bmp output.png

$ scorpiox-renderimage output.png

Sixel-capable terminals

# On terminals with Sixel support (mlterm, xterm +sixel, foot)

# scorpiox-renderimage auto-detects and uses high-fidelity Sixel output

$ scorpiox-renderimage logo.png

[renders pixel-accurate image via Sixel protocol]

📦 Source & Build Info

Source File

scorpiox/scorpiox-renderimage.c

Lines of Code

348

Dependencies

libsxutil

Platforms

linux-x64 · linux-arm64 · macos-arm64 · windows-x64

scorpiox-renderimage🔨 build

📖 Description

⚙️ Flags & Options (0)

💡 Usage Examples

📦 Source & Build Info

🔗 Related Tools