phpsd/README.md

181 lines
5 KiB
Markdown
Raw Permalink Normal View History

# Legacy Stable Diffusion WebUI — Summer Update ☀️
![phpsd-logo-256](https://github.com/user-attachments/assets/9ca5934f-97e2-4885-bf06-a93dcfc393a6)
A minimalistic, **JavaScript-free** web interface for Stable Diffusion, designed for compatibility with **legacy web browsers** like Internet Explorer 4, Netscape 4.x, and even Classilla on Mac OS 9.
Built for long-term access to AI image generation using the AUTOMATIC1111 API — from modern GPUs to vintage clients.
---
## 🆕 Summer 2025 Update Highlights
- 🗂 **File structure cleanup** Generation, prompt saving, and UI now fully separated for better maintainability.
-**True loading screen** `loading.php` now displays a loading message before generation starts.
- 💾 **"Save Prompt" moved to result page** Save your prompt right after generation from `result.php`.
- 📉 **Improved compression** Lowered ImageMagick quality to 75 (from 85) for **9093% file size reduction**.
-**Default sampler set to `Euler a`**, which works especially well with **Illustrious XL** (the recommended model).
- 🧼 Overall code quality and parameter consistency improved.
---
## 🔧 Features
- No JavaScript — 100% HTML 4.01 and PHP
- Ultra-lightweight for slow or vintage clients
- LORA model support via `[name:weight]` syntax
- Prompt saving and loading via `saved-prompts.json`
- Server-side PNG ➜ JPG conversion with ImageMagick
- Compatible with AUTOMATIC1111 Stable Diffusion WebUI
- Configurable generation settings:
- Image size
- CFG scale
- Steps
- Sampler method
- Negative prompt support
---
## 🌐 Browser Compatibility
Tested on:
- ✅ Internet Explorer 46 (Windows 952000)
- ✅ Netscape 4.x
- ✅ Classilla (Mac OS 9)
- ✅ Firefox ESR 102+ (modern systems)
2024-12-15 18:08:27 -05:00
---
2024-12-15 18:08:27 -05:00
## 📦 Requirements
2024-12-15 18:08:27 -05:00
- **Back-end:**
AUTOMATIC1111 Stable Diffusion WebUI running with `--api`
https://github.com/AUTOMATIC1111/stable-diffusion-webui
2024-12-15 18:08:27 -05:00
- **Front-end Server:**
Linux server with:
- PHP 8+
- ImageMagick
- cURL
- Any web server (Apache, nginx, or FrankenPHP)
2024-12-15 18:08:27 -05:00
- **Client:**
Any browser capable of submitting forms and rendering HTML 4.01
(Yes, it really works on Windows NT 4.0)
2024-12-16 15:03:29 -05:00
---
2024-12-15 18:08:27 -05:00
## 🧪 Installation
2024-12-15 18:08:27 -05:00
1. Start AUTOMATIC1111's WebUI with `--api`
2. Install PHP and ImageMagick on your web server
3. Place `index.php`, `loading.php`, `generate.php`, and `result.php` in your web directory
4. Ensure write permissions for:
- `saved-prompts.json`
- Your web server's root directory containing the phpsd files, this is where images will be stored
5. Access `index.php` from a browser and start generating!
2024-12-15 18:08:27 -05:00
---
2024-12-15 18:08:27 -05:00
## 🧭 Usage Guide
2024-12-15 18:08:27 -05:00
1. Open `index.php`
2. Type your prompt and negative prompt (optional)
3. Adjust generation parameters
4. Submit ➜ loading screen ➜ image result
5. Save your favorite prompts directly from `result.php`
2024-12-15 18:08:27 -05:00
---
## 🧠 LORA Support
Use the syntax:
```text
[lora-name:weight]
````
2024-12-15 18:08:27 -05:00
Example:
```text
a high-detail wizard portrait [wizard-style:0.8]
```
2024-12-15 18:08:27 -05:00
Weight values typically range from `0.1` to `1.0`
2024-12-15 18:08:27 -05:00
---
## 📸 Image Processing Notes
* Generated PNGs are automatically converted to optimized JPGs
* ImageMagick runs with:
```
-quality 75 -strip -interlace Plane -gaussian-blur 0.05 -sampling-factor 4:2:0
```
* Resulting file sizes reduced by \~9093%, ideal for slow connections and legacy hardware
---
## 🧭 System Architecture
Below is a flowchart diagram representing the separation of concerns between the legacy client and the backend server during prompt submission and image generation.
2025-06-22 19:31:02 -04:00
![Screenshot 2025-06-22 182155](https://github.com/user-attachments/assets/810aa3d3-c13d-4aeb-9a10-121e501d89b4)
---
## 🖥️ Screenshots
### Running on Windows 2000 SP2 with IE 5 — Illustrious XL Output (June 22, 2025 Summer Update)
2025-06-22 19:31:02 -04:00
![Screenshot 2025-06-22 174921](https://github.com/user-attachments/assets/0224a7ab-fc9a-4aeb-bfc1-5a48d476041e)
This image was generated using `Euler a` sampler and the Illustrious XL model, processed entirely through the `phpsd` legacy frontend. Displayed here in Internet Explorer 5 on Windows 2000 SP2.
### Running on Mac OS 9 + Classilla
![screenshot2](https://github.com/user-attachments/assets/5284613c-9060-49d4-aed6-5d7fa1d041d3)
### Firefox ESR 115 on Debian 12
![Screenshot 2024-12-14 143036](https://github.com/user-attachments/assets/9745d00f-57cc-4788-a17d-43782d7e6fa3)
---
## 🖼️ Legacy Wallpaper Output
Dont just generate — **decorate**.
All generated images are:
- Optimized for ultra-low size (JPG @ quality 75)
- CRT-safe resolution options
- Perfect for Retro PC wallpapers
Whether youre browsing from Classilla or setting your ThinkPad T21s background, `phpsd` delivers.
## 🤝 Contributing
Pull requests, forks, and retro tweaks welcome!
Feel free to adapt the UI for even older setups or customize layouts per browser profile.
---
2025-06-22 19:31:02 -04:00
## 📜 License
MIT License
---
2024-12-15 18:08:27 -05:00
## 🧠 Credits
2024-12-15 18:08:27 -05:00
* Front-end & optimization by markmental
* Powered by [AUTOMATIC1111s Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui)
2024-12-15 18:08:27 -05:00
---
2024-12-15 18:08:27 -05:00
2025-06-22 19:31:02 -04:00