Metadata-Version: 2.3
Name: imageterminal
Version: 0.1.0
Summary: A  terminal tool for advanced image manipulation including a filetype converter, background remover, and blazing fast upscaling AI using cv2.
License: Apache-2.0
Author: Ian Tawileh
Requires-Python: >=3.8
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: numpy (>=2.3.2,<3.0.0)
Requires-Dist: opencv-contrib-python (>=4.12.0.88,<5.0.0.0)
Requires-Dist: pillow (>=11.3.0,<12.0.0)
Requires-Dist: pillow-avif-plugin (>=1.5.2,<2.0.0)
Requires-Dist: rembg (>=2.0.67,<3.0.0)
Requires-Dist: textual (>=5.2.0,<6.0.0)
Description-Content-Type: text/markdown

# Image Terminal

A powerful terminal-based image manipulation program built with Python and Textual. Image Terminal provides an intuitive interface for advanced image processing tasks including format conversion, background removal, and AI-powered upscaling.

![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)
![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)

## Features

### 🔄 Format Conversion
Convert between multiple image formats with ease:
- **Supported formats**: PNG, JPG, JPEG, BMP, WEBP, AVIF
- **Smart format detection**: Automatically detects current format
- **Quality preservation**: Maintains image quality during conversion

### 🎨 Background Removal
Remove backgrounds from images using advanced AI:
- **AI-powered**: Uses the `rembg` library for precise background removal
- **Transparent backgrounds**: Creates PNG files with transparent backgrounds
- **Format compatibility**: Handles JPEG/JPG with white background fallback
- **High quality**: Preserves subject details and edges

### 🚀 AI Image Upscaling
Enhance image resolution with deep learning:
- **Multiple scale factors**: 2x, 3x, and 4x upscaling options
- **EDSR models**: Uses Enhanced Deep Super-Resolution models
- **Quality enhancement**: Improves both resolution and image quality
- **Format support**: Works with all major image formats

# imageterminal

## Installation

**Requirements**  
- Python 3.8+

### From PyPI

pip install imageterminal-iantawileh

text

### From Source

git clone https://github.com/yourusername/imageterminal.git
cd imageterminal
pip install -e .


## Usage

Run the app from your terminal:
```
imageterminal
```

### Basic Steps

1. **Start the app:**  
   Run `imageterminal` in your terminal.

2. **Upload your image:**  
   Click "Upload Image!" and select a file.

3. **Pick a tool:**  
   - Change Filetype
   - Remove Background
   - Scale Image

4. **Save your result:**  
   Choose where to save the processed image.

### Supported Formats

- PNG (.png)
- JPEG (.jpg, .jpeg)
- BMP (.bmp)
- WEBP (.webp)
- AVIF (.avif)

**That's it! You're ready to use imageterminal.**

## Technical Details

### Dependencies
- **Textual**: Modern terminal UI framework
- **Pillow**: Python Imaging Library
- **OpenCV**: Computer vision and image processing
- **rembg**: AI background removal
- **NumPy**: Numerical computing
- **PyTorch**: Deep learning framework (via rembg)

### Performance Notes
- **Background removal**: Typically takes 5-15 seconds depending on image size
- **AI upscaling**: Can take 1-5 minutes depending on scale factor and image size
- **Format conversion**: Near-instantaneous for most operations

### System Requirements
- **RAM**: Minimum 4GB (8GB+ recommended for large images)
- **Storage**: ~500MB for dependencies and models
- **CPU**: Multi-core processor recommended for faster processing

## File Structure
```
imageterminal/
├── main.py              # Main application file
├── style.tcss           # Textual CSS styling
├── EDSR_x2.pb          # 2x upscaling model
├── EDSR_x3.pb          # 3x upscaling model
├── EDSR_x4.pb          # 4x upscaling model
├── pyproject.toml      # Project configuration
├── requirements.txt    # Python dependencies
└── README.md          # This file
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

## License

This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/Iantaw/imageterminal/blob/main/LICENSE) file for details.

## Acknowledgments

- **Textual** - For the excellent terminal UI framework
- **OpenCV** - For computer vision capabilities
- **rembg** - For AI background removal
- **EDSR** - For super-resolution models
- **Pillow** - For image processing utilities

## Author

Ian Tawileh

---

*Image Terminal - Transform your images with the power of AI, all from your terminal.*
