💎 Crystalline

Professional Image Enhancement Suite

Transform low-resolution images into crystal-clear masterpieces using advanced RealESRGAN AI technology.

---

⚡ Quick Start

🆕 First Time Installation:

1. Run INSTALL.bat (takes 5-10 minutes)
2. Wait for installation to complete
3. Double-click the "Crystalline" icon on your desktop
4. Start enhancing!

🔄 After Installation:

• Double-click the "Crystalline" desktop icon
• OR run START.bat from this folder

---

✨ Features

• 🚀 AI Upscaling - 4x resolution enhancement with RealESRGAN
• ⚡ GPU Acceleration - CUDA support for NVIDIA cards
• 🎨 Live Adjustments - Real-time brightness, contrast, saturation
• 💾 Batch Processing - Process multiple images at once
• 🖼️ Format Support - JPG, PNG, WebP input/output
• 🎭 Watermarking - Add custom text/image watermarks
• 👁️ 3 Comparison Modes - Slider, Toggle, Side-by-side views
• 📐 Smart Cropping - Crop before enhancement
• 🖥️ Terminal Console - Monitor processing in real-time

---

🎯 System Requirements

Minimum:

• Windows 10/11 (64-bit)
• 8GB RAM
• 5GB free disk space
• Internet connection (for installation)

Recommended:

• NVIDIA GPU with CUDA support (RTX series)
• 16GB+ RAM
• SSD storage
• Updated GPU drivers

---

🎮 Keyboard Shortcuts

Shortcut	Action
Space	Toggle before/after (in Toggle mode)
`Ctrl+``	Open/close terminal console
Ctrl+Shift+H	Activate hacker mode (Matrix rain!)
Ctrl+Scroll	Zoom in/out on canvas
Shift+Drag	Pan image when zoomed

---

📁 Project Structure

crystalline/
├── INSTALL.bat          # Run this first!
├── START.bat            # Launch application
├── README.md            # This file
├── CHANGELOG.md         # Version history
├── crystalline.ico      # Application icon
├── config.json          # Settings
├── launcher.py          # Python launcher
├── backend/             # FastAPI server
├── frontend/            # React UI
├── installer/           # Installation scripts
└── logs/                # Application logs

---

🆘 Troubleshooting

Installation fails?

• Check logs/install_*.log for error details
• Make sure you have administrator privileges
• Verify Python 3.10+ is available
• Check internet connection

Backend won't start?

• Check logs/backend.log
• Verify port 5000 is free (not used by other apps)
• Try running START.bat as administrator

GPU not detected?

• Update NVIDIA drivers from nvidia.com
• Install CUDA Toolkit 11.8
• Restart computer after driver installation

Image processing errors?

• Check image file isn't corrupted
• Verify supported format (JPG, PNG, WebP)
• Look at terminal console for error messages

---

📝 Tips for Best Results

1. Use high-quality source images - Garbage in, garbage out!
2. Crop strategically - Focus on important areas
3. Adjust denoise strength - Lower for photos, higher for drawings
4. Use batch processing - Process multiple images efficiently
5. Compare results - Use Toggle mode for quick before/after checks
6. Save originals - Always keep your original images

---

🔄 Updates

Current version: v1.2

See CHANGELOG.md for detailed version history and bugfixes.

---

💡 Need Help?

• Check logs in logs/ folder
• Read CHANGELOG.md for known issues
• Open terminal console (Ctrl+`) to see real-time status

---

Crystalline v1.2 - Made with 💎

Powered by RealESRGAN | NVIDIA CUDA | FastAPI | React