diff --git a/README.md b/README.md new file mode 100644 index 0000000..ccd7f80 --- /dev/null +++ b/README.md @@ -0,0 +1,126 @@ + +# đŸ–Œïž Image Reducer WebApp + +**Image Reducer** est une application web simple et efficace, dĂ©veloppĂ©e avec [Bottle](https://bottlepy.org/) et [Pillow](https://python-pillow.org), qui permet d’uploader un dossier entier d’images, de les redimensionner (en parallĂšle !), et de tĂ©lĂ©charger un `.zip` contenant les images optimisĂ©es. + +💡 L'interface est moderne et inclut une galerie avec **prĂ©visualisation Lightbox**, un **loader animĂ©**, et une gestion du cache automatique. + +--- + +## 🚀 FonctionnalitĂ©s + +- ✅ Upload d’un **dossier complet d’images** +- ✅ Redimensionnement via **ratio personnalisable** +- ✅ Traitement **multi-process** (accĂ©lĂ©rĂ©) +- ✅ Conservation des **mĂ©tadonnĂ©es EXIF** +- ✅ Interface web avec **loader**, **galerie** & **Lightbox zoom** +- ✅ TĂ©lĂ©chargement d’un **ZIP** contenant les images rĂ©duites +- ✅ PrĂȘt Ă  dĂ©ployer avec **Docker** + +--- + +## 📾 DĂ©mo (capture Ă©cran) + +*📾* Ă  insĂ©rer ici si tu veux des images de l’UI + +--- + +## 📩 Installation locale + +### 1. Cloner le projet + +```bash +git clone https://git.jool-tech.com/Jool-Monitor/image-reducer.git +cd image-reducer +``` + +### 2. CrĂ©er un environnement virtuel (optionnel mais recommandĂ©) + +```bash +python -m venv venv +source venv/bin/activate # sous Windows : venv\Scripts\activate +``` + +### 3. Installer les dĂ©pendances + +```bash +pip install -r requirements.txt +``` + +### 4. Lancer l’application + +```bash +python app.py +``` + +AccĂ©dez Ă  l’interface sur [http://localhost:8080](http://localhost:8080) + +--- + +## 🐳 Utilisation avec Docker + +### 1. Construire l’image + +```bash +docker build -t image-reducer . +``` + +### 2. Lancer le conteneur + +```bash +docker run -p 8080:8080 image-reducer +``` + +### 3. Avec synchronisation en live (dĂ©veloppement) + +```bash +docker run -p 8080:8080 -v $(pwd):/app image-reducer +``` + +--- + +## 📁 Structure du projet + +``` +image-reducer/ +├── app.py # Application Bottle principale +├── requirements.txt # DĂ©pendances Python +├── Dockerfile # Image Docker prĂȘte Ă  builder +├── views/ # Templates HTML Bottle +│ ├── index.tpl # Formulaire upload avec loader +│ └── result.tpl # Page de galerie + Lightbox + download +``` + +--- + +## ⚙ Technologies + +- Python 3.9+ +- Bottle (micro-framework web) +- Pillow (traitement d’images) +- Lightbox2 (galerie zoom) +- Docker (conteneurisation) +- HTML5 / CSS3 + +--- + +## ✅ Roadmap (Ă  venir ?) + +- [ ] Affichage de la **qualitĂ© d’image** +- [ ] Option pour choisir un **format de sortie** (`.jpg`, `.webp`, `.png`) +- [ ] Progression en temps rĂ©el (AJAX) +- [ ] Authentification utilisateur (pour usage pro ?) +- [ ] IntĂ©gration Django + Celery (scalabilitĂ© massive 🚀) + +--- + +## 🙌 CrĂ©dits + +DĂ©veloppĂ© avec ❀ par [Votre Nom ou Organisation] +Design frontend custom, inspirĂ© d'UX modernes (Dropbox, Google Photos) + +--- + +## 📄 Licence + +Ce projet est sous licence MIT — libre Ă  toi de l’utiliser, modifier et dĂ©ployer 🚀