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.
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
rembglibrary 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
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
-
Start the app:
Runimageterminalin your terminal. -
Upload your image:
Click "Upload Image!" and select a file. -
Pick a tool:
- Change Filetype
- Remove Background
- Scale Image
-
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
- Upscaling: Takes around 5-15 seconds depending on scale factor and image size
- Format conversion: Near-instantaneous for most operations
System Requirements
- RAM: Minimum 1GB (2GB+ recommended for large images)
- Storage: ~50MB 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
├── 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 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.
Metadata
Release files for imageterminal 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| imageterminal-2.0.1.tar.gz | 10.0 kB | Without provenance | Details for imageterminal-2.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| imageterminal-2.0.1-py3-none-any.whl | Python 3 | none | any | Details for imageterminal-2.0.1-py3-none-any.whl |
Total release size: 21.4 kB
Release files / imageterminal-2.0.1.tar.gz
| Download URL | imageterminal-2.0.1.tar.gz |
|---|---|
| Size | 10.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0bf61fddc7d331c0998db9bf52ef5d6b281b245f92aa9c68281cd98e615c45c
|
|
BLAKE2b-256 checksum How to use checksums |
964b26bdbb3b845e4860dfa1c4af6e20836208db7cda0e00d903d1484e197c34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / imageterminal-2.0.1-py3-none-any.whl
| Download URL | imageterminal-2.0.1-py3-none-any.whl |
|---|---|
| Size | 11.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7b6dbc85eea2ea93fb62614db3da02baffa3a383cb440d6edb646c7aa719769f
|
|
BLAKE2b-256 checksum How to use checksums |
f155b773b2387fef879458da53d3c62db111ea30b48fdd3625f6f79c73d6d129
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for imageterminal 2.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.