sora-digital-photo-frame

SORA Frame is an open-source digital photo frame that transforms any device with a web browser into a full-screen slideshow display. It features remote photo management through an admin panel accessible on your network, drag-and-drop uploads, and organized folder structures for targeted slideshows. The platform supports JPEG, PNG, WebP, and GIF formats with smooth fade transitions, keyboard shortcuts, and Wake Lock support to keep displays active. Teams can deploy it on tablets, laptops, smart TVs, or Raspberry Pi devices for displaying rotating images, announcements, or content across multiple locations.

[{"step":"Install Sora on your device","action":"Run the installer for your OS (e.g., `curl -sSL https://sora.example/install | bash` for Linux). For Raspberry Pi, use the dedicated image: `wget https://sora.example/pi-image.img.xz && xz -d pi-image.img.xz && dd if=pi-image.img of=/dev/sdX`.","tip":"Use a Raspberry Pi OS Lite image for headless operation. Disable screensaver to prevent display sleep."},{"step":"Configure image sources","action":"Edit the config file at `/etc/sora/config.json` to specify local folders, cloud storage paths (e.g., Google Drive folder ID), or API endpoints (e.g., `https://api.example.com/images?category=family`). Use the Sora CLI to test connections: `sora sync --test [SOURCE_NAME]`.","tip":"For cloud storage, generate API keys with read-only access. For local folders, ensure the Sora service has read permissions."},{"step":"Set display rules","action":"Define rotation schedules in the config file. Example: `{\"photos\": {\"duration\": 10, \"weight\": 0.6}, \"announcements\": {\"duration\": 15, \"weight\": 0.2}, \"dashboards\": {\"duration\": 30, \"weight\": 0.2}}`. Use the Sora web interface (port 8080) to preview changes live.","tip":"Start with shorter durations (5-10 seconds) for testing. Increase once you confirm all content loads correctly."},{"step":"Enable auto-start","action":"Set up a systemd service for auto-start on boot: `sudo nano /etc/systemd/system/sora-frame.service`. Add the service file with `ExecStart=/usr/bin/sora start`, then run `sudo systemctl enable --now sora-frame`.","tip":"Test auto-start by rebooting the device. Verify the service status with `sudo systemctl status sora-frame`."},{"step":"Monitor and adjust","action":"Use the Sora dashboard (accessible via the device's IP address) to monitor performance. Check logs for errors (`journalctl -u sora-frame -f`) and adjust configurations as needed. Schedule periodic syncs (e.g., `0 3 * * * sora sync`) to update content.","tip":"For dashboards, use lightweight APIs (e.g., JSON endpoints) to avoid overloading the device. Cache responses locally to reduce latency."}]