A Windows screensaver that displays a slideshow of photos from your Photoprism server.
This is project is under active development, things will break as new features are added. If you have issues try grabbing an older release.
- Fetch photos from Photoprism via API
- Secure credential storage using Windows Credential Manager
- Filter photos by:
- Albums (multi-select)
- Year and month
- Favorites only
- Exclude NSFW content
- Random selection
- Full-screen slideshow with smooth transitions
- Photo caching for offline viewing
- Preview mode support
- Download the latest release from the Releases page
- Extract the ZIP file
- Right-click
PhotoprismSaver.scrand select "Install"- Note: Windows SmartScreen may show a warning because the app isn't code-signed yet
- Click "More info" then "Run anyway" to proceed with installation
- This warning only appears once during installation
- Configure via Display Settings > Screen Saver > Settings
Alternative: Manually copy PhotoprismSaver.scr to C:\Windows\System32
For information about code signing and eliminating the SmartScreen warning, see CODE_SIGNING.md.
Right-click the .scr file and select "Configure" or use the Settings button in Display Properties to:
- Set your Photoprism server URL
- Manage credentials securely
- Select albums and filters
- Configure slideshow preferences
Requirements:
- .NET 6.0 SDK or later
- Windows 10/11
dotnet restore
dotnet build -c ReleaseThe built .scr file will be in bin/Release/net6.0-windows/
Program.cs- Entry point and command-line argument handlingScreensaverForm.cs- Full-screen slideshow displayConfigForm.cs- Configuration dialogPreviewForm.cs- Preview mode for Display PropertiesPhotoprismClient.cs- Photoprism API integrationSettings.cs- Settings management (Registry)Models/- Data models for API responses
MIT License