TYM is a cross-platform tool that renders image files in your terminal. It uses VT100 escape codes to display 24-bit true color images.
- Unicode supported monospace font
- VT100 compatible terminal emulator with true color support
Get the lastest version from Releases page. You can also get a debug build from Actions tab.
Some browsers may block download because they filter all files with .exe suffix even if they are plain text.
No additional installation required.
If you want to execute TYM from a shell don't forget to update your PATH variable.
tym [--help] [--version] <file> [<options>]| Short form | Long form | Default value | Description |
|---|---|---|---|
-r |
--resampler |
MitchellNetravali |
Resampling algorithm for downsizing. |
-l |
--list-resamplers |
false |
List available resampling algorithms. |
-x |
--x-margin |
0 |
Left margin size as characters. Shifts output to right. |
-y |
--y-margin |
0 |
Top margin size as characters. Shifts output to bottom. |
-w |
--width |
0 (autosize) |
Output width as pixels. |
-h |
--height |
0 (autosize) |
Output height as pixels. |
-m |
--resize-method |
Contain |
Resizing mode. |
-f |
--fullscreen |
false |
Use fullscreen. |
-c |
--clear |
false |
Clear downloaded cache folder. |
The fullscreen option overrides margin and size arguments.
TYM uses special Unicode characters to improve image scaling. That causes each character to contain 2 pixels vertically. That means if you specify top margin as 3, it will shift the output by 3 characters which is equals to 6 pixels.
View local image with default settings:
tym example.pngView remote image with default settings:
tym https://example.com/image.pngView remote file with and resize to 96x64:
tym https://example.com/image.png -w 96 -h 54View local file with fullscreen and cover all buffer area:
tym example.png -f -m Cover
This tool is built on .Net 7 so it requires .Net SDK version >= 7 while building.
For AOT binary compilation, check official documentation for dependencies. This packages are only required while publishing. Skip this step if you're going to use JIT compiled binary.
You can create pull requests and issues to help development. Also starring the repo will give me motivation.
Image library: SixLabors ImageSharp
TYM created by Segilmez06