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:
15
README.md
15
README.md
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user