Server-side PPTX shift: Docs updated (README, copilot instructions) to reflect PDF-only workflow; legacy LibreOffice paths marked optional.

Setup improvements: Added pi-setup.sh (clone-before-venv, requirements-based install) + HDMI-CEC cec-utils inclusion.
Dependencies: Corrected python-dotenv, added server-side rendering + CEC notes in requirements.txt.
CEC integration: Confirmed and documented usage; minor wording adjustments.
This commit is contained in:
RobbStarkAustria
2025-11-23 11:14:35 +01:00
parent 6617c3d7b9
commit d14789b1f4
6 changed files with 165 additions and 330 deletions

View File

@@ -4,7 +4,7 @@ Digital signage system for Raspberry Pi that displays presentations, videos, and
## 🎯 Key Features
- **Automatic Presentation Display** - PPTX files converted to PDF and displayed with Impressive
- **Automatic Presentation Display** - Server renders PPTX to PDF; client displays PDFs with Impressive
- **Auto-Advance Slideshows** - Configurable timing for automatic slide progression
- **Loop Mode** - Presentations can loop infinitely or quit after last slide
- **HDMI-CEC TV Control** - Automatic TV power on/off based on event scheduling
@@ -25,8 +25,8 @@ Digital signage system for Raspberry Pi that displays presentations, videos, and
### Software
- Raspberry Pi OS (Bookworm or newer)
- Python 3.x
- LibreOffice (for PPTX→PDF conversion)
- Impressive (PDF presenter with auto-advance)
- (Optional legacy) LibreOffice ONLY if older workflow still sends raw PPTX; otherwise not required
- Chromium browser (for web content)
- VLC or MPV (for video playback)
- CEC Utils (for HDMI-CEC TV control - optional)
@@ -116,7 +116,7 @@ Or use the startup script:
The system uses **Impressive** as the PDF presenter with native auto-advance and loop support:
1. **PPTX files** are automatically converted to PDF using LibreOffice headless
1. **PPTX files** are converted to PDF server-side (client receives ready-made PDFs)
2. **PDF files** are displayed directly with Impressive
3. **Auto-advance** uses Impressive's built-in `--auto` parameter
4. **Loop mode** uses Impressive's `--wrap` parameter (infinite loop)
@@ -362,10 +362,10 @@ which impressive
# If not found: sudo apt-get install impressive
```
**Check LibreOffice installation:**
**Legacy LibreOffice (only if still receiving raw PPTX):**
```bash
which libreoffice
# If not found: sudo apt-get install libreoffice
# Optional install (legacy only): sudo apt-get install libreoffice
```
**Check logs:**
@@ -373,9 +373,8 @@ which libreoffice
tail -f logs/display_manager.log
```
### Presentations don't convert from PPTX
**Verify LibreOffice headless:**
### Legacy PPTX Conversion (Deprecated)
Server performs all PPTX→PDF rendering. Use these commands only if supporting an older workflow still sending PPTX:
```bash
libreoffice --headless --convert-to pdf --outdir /tmp presentation.pptx
ls -l /tmp/*.pdf