🖼️ imagectl — Batch Resize, Mask & Compress (Web UI)
imagectl is a lightweight and fast batch image processing tool with a clean Streamlit Web UI.
Resize (px or cm with DPI), apply circle/ellipse masks, smart compression to target size, and range‑based selection by filename — then download all results as a single ZIP.
Perfect for creators, e‑commerce, thumbnails, social media, and bulk optimization.
✨ Features
- Resize using px or cm @ DPI
- Mask: Circular or elliptical cut‑out (with transparency)
- Compression: Auto‑adjusts JPEG quality to reach max KB
- Supported formats: JPG / PNG / WebP / BMP
- Smart range filter based on numbers in filenames:
- Examples:
5,2-6,-4,7-,1,3,6-9,12-
- Examples:
- Auto‑index option for files without numbers (1..N)
- Export all results as a single ZIP
🚀 Quick Start
Recommended: use uv for fast development, or pip normally.
(PyPI install section will be added after publishing)
Using uv (local dev)
git clone https://github.com/TamerOnLine/imagectl.git
cd imagectl
uv sync
uv run imagectl --port 8600
Using pip (local dev)
git clone https://github.com/TamerOnLine/imagectl.git
cd imagectl
pip install -e .
imagectl --port 8600
Default port: 8501. Use
--port 8600to change.
🧑💻 CLI / Commands
Two console scripts are provided:
imagectl→ Launch Web UI (Streamlit)imagectl-web→ Same as above (explicit Web name)
Examples:
imagectl
imagectl --port 8600
imagectl-web --port 9000
Then open:
http://localhost:8501
# or
http://localhost:8600
📥 Usage (inside UI)
- Upload one or multiple images (JPG/PNG/WebP/BMP)
- Choose size: px or cm + DPI
- Optional: Circle or Ellipse mask
- Set Max size (KB) for smart compression
- Optional: enter a Range to filter which images to process
5,2-6,-4,7-,1,3,6-9,12-
- Click Process ✨ and download the ZIP
If filenames lack numbers, enable Auto‑index to number them by upload order.
🖼️ Screenshots / Demo (Placeholders)
| Upload & Preview | Settings | Download ZIP |
|---|---|---|
| (screenshot 1) | (screenshot 2) | (screenshot 3) |
Add a short GIF (6–10s) showing: upload → adjust → download.
Suggested size: 900×500
Filename: demo.gif
🗺️ Roadmap
- Initial release: resize/mask/compress + ranges
- CLI batch processing (no UI)
- Improved PNG & WebP compression
- Basic filters (sharpness / contrast / bg remove)
- API mode for integration
🤝 Contributing
Contributions are welcome!
- Open an issue
- Fork the repo
- Create a feature branch
- Submit a PR
🪪 License
MIT — see LICENSE
🔗 Links
1 maintainer
Metadata
1 maintainer
Release files for imagectl 0.1.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 | |
|---|---|---|---|---|
| imagectl-0.1.1.tar.gz | 12.6 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| imagectl-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.6 kB
Release files / imagectl-0.1.1.tar.gz
| Download URL | imagectl-0.1.1.tar.gz |
|---|---|
| Size | 12.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f4e6aaa14be83fc4031d420687c36f43130670d840799f402283eb7b42f9f48b
|
|
BLAKE2b-256 checksum How to use checksums |
3cc5b0c42bd343e095c0a336ea8d7d903f507e609607042baf521a176b1f4efb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2025.
Transparency logRelease files / imagectl-0.1.1-py3-none-any.whl
| Download URL | imagectl-0.1.1-py3-none-any.whl |
|---|---|
| Size | 11.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b65cca91672f45cb22c12a396357ec42e8098d9b220230c883db3486917a8012
|
|
BLAKE2b-256 checksum How to use checksums |
4dbb241bfc7c574bdd21f0a85730f626e09fb39a915edc3faf3bd2b24c417e7a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2025.
Transparency logSecurity for imagectl 0.1.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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for imagectl-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2025.
Transparency logA 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.
