69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# 🚀 Quality Recticel Print Service - Quick Setup
|
|
|
|
## 📦 What You Get
|
|
- **Silent PDF Printing** - No more manual downloads!
|
|
- **Automatic Detection** - Smart fallback when service unavailable
|
|
- **Zero Configuration** - Works out of the box
|
|
|
|
## ⚡ 2-Minute Installation
|
|
|
|
### Step 1: Install Windows Service
|
|
1. **Right-click** `install_service.bat`
|
|
2. Select **"Run as administrator"**
|
|
3. Click **"Yes"** and wait for completion
|
|
|
|
### Step 2: Install Chrome Extension
|
|
1. Open Chrome → `chrome://extensions/`
|
|
2. Enable **"Developer mode"**
|
|
3. Click **"Load unpacked"** → Select `chrome_extension` folder
|
|
|
|
### Step 3: Verify Installation
|
|
- Visit: `http://localhost:8765/health`
|
|
- Should see: `{"status": "healthy"}`
|
|
|
|
## 🎯 How It Works
|
|
|
|
| Service Status | Button Appearance | What Happens |
|
|
|---------------|-------------------|--------------|
|
|
| **Running** ✅ | 🖨️ **Print Labels (Silent)** (Green) | Direct printing |
|
|
| **Not Running** ❌ | 📄 **Generate PDF** (Blue) | PDF download |
|
|
|
|
## ⚠️ Troubleshooting
|
|
|
|
| Problem | Solution |
|
|
|---------|----------|
|
|
| **Service won't start** | Run `install_service.bat` as Administrator |
|
|
| **Chrome extension not working** | Reload extension in `chrome://extensions/` |
|
|
| **Can't connect to localhost:8765** | Check Windows Firewall (port 8765) |
|
|
| **Nothing prints** | Verify default printer is set up |
|
|
|
|
## 🔧 Management Commands
|
|
|
|
```bash
|
|
# Check service status
|
|
python service_manager.py status
|
|
|
|
# Restart service
|
|
python service_manager.py restart
|
|
|
|
# Uninstall service
|
|
python service_manager.py uninstall
|
|
```
|
|
|
|
## 📍 Important Notes
|
|
|
|
- ⚡ **Auto-starts** with Windows - no manual intervention needed
|
|
- 🔒 **Local only** - service only accessible from same computer
|
|
- 🖨️ **Uses default printer** - configure your default printer in Windows
|
|
- 💾 **Don't move files** after installation - keep folder in same location
|
|
|
|
## 🆘 Quick Support
|
|
|
|
**Service API**: `http://localhost:8765`
|
|
**Health Check**: `http://localhost:8765/health`
|
|
**Printer List**: `http://localhost:8765/printers`
|
|
|
|
**Log File**: `print_service.log` (same folder as installation)
|
|
|
|
---
|
|
*Installation takes ~5 minutes • Zero maintenance required • Works with existing Quality Recticel web application* |