Getting Started
Quick Start
Get your digital photo frame running in minutes
Get started in three steps
Set up your Sora Digital Photo Frame and start displaying your photos.Step 1: Prerequisites and Installation
Install Node.js
Install Node.js
Ensure you have Node.js 18.0 or higher installed on your system.Check your version:Download from nodejs.org if needed.
Clone and install
Clone and install
- Clone the repository:
- Install dependencies:
The installation includes all necessary dependencies for both frontend and backend.
Step 2: Configuration
Environment setup
Environment setup
- Create a
.envfile in the root directory:
- Configure your settings:
The default settings work great for most setups!
Step 3: Launch your photo frame
Start the application
Start the application
- Start the server:
- Open your browser and navigate to:
- Your digital photo frame is now running!
Next steps
Now that your photo frame is running, explore these features:Admin Panel
Upload and manage your photos with the web-based admin interface.
Keyboard Controls
Learn slideshow navigation shortcuts and controls.
Network Setup
Access your photo frame from other devices on your network.
Configuration Guide
Customize slideshow timing, image quality, and display settings.
Access from other devices
Network Access: To view your photo frame from tablets, phones, or other computers, replace
localhost with your computer’s IP address (e.g., http://192.168.1.100:3000).Troubleshooting
Port already in use
Port already in use
If port 3000 is already in use, change the
PORT in your .env file:Images not displaying
Images not displaying
- Ensure image files are in the correct format (JPG, PNG, GIF, WebP)
- Check that the
PHOTOS_PATHin.envpoints to the correct directory - Verify file permissions allow reading