Skip to main content

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 Python

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

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
  • 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)

Source distribution for imageterminal 2.0.1
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)

Table of built distributions (wheels) for imageterminal 2.0.1
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page