🧊 Mass Tinify & WebP

Stop wasting time compressing images one by one.

A simple tool designed to bulk-compress and transform images into WebP without the headache of the 3-image limit on TinyPNG's web interface.

I built this because manually clicking "Download All" for dozens of assets was driving me crazy. If you have folders full of JPGs/PNGs that need to be web-ready in seconds, this is for you.

---

🔥 Why use this?

• ⚡ Mass Optimization: Pick a folder, hit go. It handles everything in its own "WebP Tiny" subfolder.
• 🖼️ Automatic WebP: Converts every file to WebP (best for web speed) by default.
• 📐 Smart Resizing: Optionally cap images at 2560px or crop them to specific ratios (16:9, 4:5, 1:1) using Tinify's intelligent algorithms.
• 💻 Local-First: It runs on your own machine. Your source images stay where they are.

---

🛠️ How to setup (The "Dev" way)

1. Requirements

Clone the repo and install the basics:

git clone https://github.com/UnLince/Mass-Tinify-and-WebP.git
cd Mass-Tinify-and-WebP
python -m venv .venv
# Windows: .venv\Scripts\activate
# Mac/Linux: source .venv/bin/activate
pip install -r requirements.txt

2. Get your Tinify API Key

You must have your own API Key to use this tool (the free tier usually gives you 500 compressions a month).

1. Grab a key at tinypng.com/developers.
2. Create a .env file in the root of this project.
3. Add your key: TINIFY_API_KEY=your_key_here

3. Run it

python execution/app.py

Open http://127.0.0.1:5000 in your browser.

---

🤖 For Non-Developers (The "AI" way)

If you don't know what a "terminal" or "venv" is, just let the AI handle it:

1. Open Claude Code, Antigravity, or your favorite AI terminal.
2. Paste this: "Hey, can you help me clone the repo at https://github.com/UnLince/Mass-Tinify-and-WebP and walk me through setting up my Tinify API Key so I can start compressing images?"
3. Follow the instructions. It will set everything up for you in about 60 seconds.

---

🔒 Security & Safety

• Local Sandbox: This is a local utility. The Flask server is meant to be run on your machine (localhost). Avoid hosting this on a public domain as it allows file system interactions.
• Secrets: Your API key lives in .env, which is strictly ignored by Git. Never share this file.
• Privacy: No images are uploaded to any server other than Tinify's official API for processing.

---

📦 Tech Stack

• Python 3.12 / Flask: Backend logic.
• Tinify API: The compression engine.
• Vanilla JS/CSS: A premium, editorial-style UI designed for utility.

Made by @UnLince because manually optimizing images is not a lifestyle.