timg可在Mac终端中纯命令行实时渲染图片为ASCII或图形协议字符画:先用brew install timg安装,再通过timg -a -c 256启用256色ASCII增强预览,或依终端类型执行timg -i(iTerm2)、timg -k(Kitty)、timg -s(Sixel)获得准图像级显示。

在Mac终端中不打开图形界面、不依赖GUI应用,仅用命令行快速获得图片内容概览——timg能将图像实时转换为ASCII字符画并直接渲染在终端里,适合远程SSH会话或极简工作流。
确认timg已正确安装并支持当前终端
运行 timg --version 查看输出;若提示 command not found,请先通过 brew install timg 安装。注意:timg必须识别出你的终端类型(如iTerm2、Kitty、WezTerm),否则默认回退到低分辨率ASCII模式,细节严重丢失。
执行 timg -l 列出可用协议;若输出含 【kitty, iterm2, sixel】 三项,说明图形协议支持完整;若只有 ascii 或 ansi,说明终端未被正确识别或缺少必要环境变量(如 KITTY_PID 或 TERM_PROGRAM=iTerm.app)。
用ASCII模式即时预览(兼容性最强)
方法一:基础ASCII渲染
输入 timg photo.jpg → 回车。这一步不加任何参数,timg自动选择ASCII模式,适用于所有终端,但仅显示灰度轮廓,无法分辨细微明暗层次。
方法二:增强对比的ASCII预览
运行 timg -a -c 256 photo.jpg → 启用256色ANSI调色板模拟灰阶,字符密度更高;【-c 256 必须显式指定,否则默认只用16色,导致天空/阴影全糊成一片】。
启用图形协议获得准图像级预览
第一步:确认终端真实类型
在iTerm2中运行 echo $TERM_PROGRAM,输出应为 iTerm.app;在Kitty中运行 echo $KITTY_PID,应返回一串数字。两者任一不满足,-i 或 -k 参数将静默失效,退化为ASCII。
第二步:按终端类型选择对应命令
iTerm2用户输入:timg -i photo.jpg → 图像以原尺寸等比缩放嵌入终端窗口底部,支持鼠标悬停查看坐标,但不支持透明通道。
Kitty用户输入:timg -k photo.jpg → 自动启用双缓冲与gamma校正,HEIC/WEBP等新格式解析更稳;若图像边缘出现错位色块,立即补加 --no-cleanup 参数重试。
第三步:Sixel通用兜底方案(如用VS Code内置终端)
执行 timg -s --sixel-colors=256 photo.jpg → 强制启用256色Sixel渲染;该模式在多数Linux终端和VS Code中可用,但macOS原生Terminal.app不支持,强行运行会输出乱码而非报错。

















