ImageReader Py

A simple Python image viewer application using tkinter and Pillow.

Features

• View images directly from the command line
• Auto-resize to fit screen while maintaining aspect ratio
• Dark theme UI
• Supports multiple image formats: PNG, JPG, JPEG, BMP, GIF, WebP, TIFF
• Press Esc to close the viewer

Requirements

• Python >= 3.14
• Pillow >= 11.0.0

Installation

# Clone the repository
git clone https://github.com/frdiskandar/ImageReader_py.git
cd ImageReader_py

# Install with uv
uv sync

# Or install with pip
pip install .

Usage

imagereader-py <image_path>

Example

imagereader-py test.png

Development

# Install dependencies
uv sync

# Run the application
uv run imagereader-py <image_path>

License

MIT