Open Source Digital Photo Frame

Website | Quick Start | Docs | API References

Turn any device with a web browser into a smart, open-source digital photo frame. Manage your photos remotely and enjoy a beautiful, full-screen slideshow on any tablet, laptop, or smart TV.

• Run Anywhere: Works on any device with a modern web browser.
• Beautiful Slideshow: A clean, full-screen photo display with smooth fade transitions, auto-advance, and random image display.
• Remote Management: A Finder-like admin panel to upload, organize, and delete photos and folders from any device on your network. Supports drag-and-drop.
• Targeted Slideshows: An interactive folder selector to display photos from specific folders, including nested ones. Your last selected folder is even remembered across sessions.
• Modern UI: Clean and responsive interface following Material Design 3 principles.
• Keyboard-Friendly: Full keyboard navigation and shortcuts for both the slideshow and admin panel.
• Always On: Wake Lock support prevents the display device from sleeping during a slideshow.
• Responsive Design: Optimized for all screen sizes and orientations.

Access the admin panel by navigating to http://your-server-ip:3000/admin and logging in with your password.

From there, you can:

• Upload Photos: Drag and drop images directly into the current folder or use the upload button.
• Organize: Create and delete nested folders to organize your library.
• Supported formats: JPEG, PNG, WebP, GIF.

On the slideshow screen, you can:

• Filter by Folder: Click the folder icon to open the folder selector. You can view all photos or select a specific folder, including nested ones. The slideshow updates instantly.
• Control Playback: Use keyboard shortcuts to play/pause, advance to the next image, and more.

• Space or K: Play/pause slideshow
• Right Arrow or N: Next image
• F: Toggle fullscreen mode
• I: Show/hide image information

This project is licensed under the ISC License - see the LICENSE file for details.

• Issues: GitHub Issues
• Documentation: See the /documentation directory for technical specifications
• Discussions: GitHub Discussions

Transform any device into a beautiful digital photo frame! 📸✨

Built with ❤️ by Claude Code - Monitored & Prompted by Saurabh K. Sharma