终端图像查看器timg使用指南
【免费下载链接】timg A terminal image and video viewer. 
项目地址: https://gitcode.com/gh_mirrors/ti/timg
概述
timg是一款功能强大的终端图像和视频查看工具，它允许用户直接在终端环境中查看静态图片、播放GIF动画、浏览PDF文件甚至观看视频。对于经常使用SSH远程连接服务器的开发者来说，timg提供了一种无需图形界面即可查看多媒体内容的便捷方式。
核心功能
timg具有以下主要特点：
- 多格式支持：支持JPEG、PNG、GIF、WebP、QOI等多种图像格式，以及MP4、WebM等视频格式
- 终端适配：自动检测终端能力，选择最佳显示方式
- 高效处理：采用多线程解码，快速加载大量图片
- 灵活布局：支持单图查看或多图网格布局
- 特殊功能：支持图像旋转、裁剪、滚动等操作
安装与基本使用
安装完成后，最基本的用法是直接指定图像文件路径：
timg image.jpg
对于多个文件，可以一次性指定：
timg image1.jpg image2.png
显示模式详解
timg提供了多种像素化显示模式，适用于不同终端环境：
1. 半块字符模式(-ph)
- 使用Unicode半块字符(▀▄)
- 每个字符单元显示2个垂直像素
- 色彩准确但分辨率较低
2. 四分之一块字符模式(-pq)
- 使用Unicode四分之一块字符
- 每个字符单元显示4个像素
- 提高水平分辨率但色彩略有损失
3. Sixel图形模式(-ps)
- 源自DEC VT终端的图形协议
- 支持256色高分辨率显示
- 需要终端支持(xterm、mlterm等)
4. Kitty图形模式(-pk)
- 使用Kitty终端的图像协议
- 支持24位真彩色
- 是目前唯一能在tmux中工作的图形模式
5. iTerm2图形模式(-pi)
- 使用iTerm2的图像协议
- 同样支持24位真彩色
- 兼容wezterm、VSCode终端等
实用功能选项
图像布局控制
--grid=3x2：以3列2行的网格显示图片-C：居中显示图像--title：显示带格式的文件名标题
图像处理
--auto-crop：自动裁剪图像边缘空白--rotate=exif：根据EXIF信息自动旋转-W：适应终端宽度(可能超出高度)-U：允许放大显示小图片
背景控制
-b color：设置透明背景色-B color：设置棋盘格背景的另一颜色--pattern-size：调整棋盘格大小
动画与视频控制
对于动态内容，timg提供了精细的控制选项：
-t5：播放5秒后停止--loops=3：循环播放3次--frames=10：仅播放前10帧--frame-offset=5：从第5帧开始播放
滚动功能
timg可以将长图像以滚动方式显示：
timg --scroll long-image.png
--scroll=100：设置滚动延迟为100毫秒--delta-move=1:1：对角线滚动(水平和垂直各1像素)
环境变量
通过环境变量可以设置timg的默认行为：
TIMG_PIXELATION：设置默认像素化模式TIMG_DEFAULT_TITLE：自定义默认标题格式TIMG_FONT_WIDTH_CORRECT：校正字体宽高比
使用技巧
-
快速浏览图片集：
timg --grid=3 -w0.5 *.jpg -
查看远程服务器上的图片：
ssh user@server "cat image.jpg" | timg - -
制作终端动画：
convert -size 200x100 xc:white -font Arial -pointsize 30 -draw "text 10,50 'Hello'" -trim +repage png:- | timg --scroll=50 - -
查看PDF文件：
timg document.pdf
常见问题解决
-
图像显示比例不正确： 尝试设置
TIMG_FONT_WIDTH_CORRECT环境变量调整宽高比 -
终端显示异常： 明确指定像素化模式，如
-pq或-pk -
tmux中图形不显示： 使用
-pk选项并确保tmux版本≥3.3 -
视频无法播放： 从管道读取时使用
-V选项明确指定视频格式
timg作为终端图像查看工具，为命令行用户提供了强大的多媒体查看能力，特别适合远程开发和服务器管理场景。通过灵活的参数组合，可以满足各种复杂的查看需求。
【免费下载链接】timg A terminal image and video viewer. 项目地址: https://gitcode.com/gh_mirrors/ti/timg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
