Release Notes¶
Back us on Patreon or GitHub Sponsors. Your continued support helps us provide regular updates and services like world maps. Thank you! 💜
You can test new features by changing the image tag in your docker-compose.yml from :latest
to :preview
, then pulling the most recent image, and finally restarting your instance.
Development Preview¶
Build 220703-18473e4d
June 29, 2022¶
Build 220629-5d7448d2
With this update, you'll enjoy a much faster and smoother scrolling experience as well as direct streaming of OGV, VP8, VP9, AV1, WebM and HEVC videos if they do not exceed the configured bitrate limit. Special thanks to Heiko Mathes and Andre Carrera for their contributions!
- UX: Much faster and smoother scrolling experience in albums and search results
- Videos: Direct streaming of OGV, VP8, VP9, AV1, WebM, and HEVC where supported
- Videos: Fixed incorrect frame rate when using NVIDIA hardware transcoding
- Sharing: Fixed the spacing of the top navigation toolbar on small screens
- RAW: Display actual dimensions as Exif metadata can be wrong, e.g. for
.NEF
files - WebDAV: Endpoints have been disabled in public mode as they cannot be used
- API: Maximum number of search results has been increased to 100,000 files
- CLI: Config command also lists
disable-webdav
andhttp-compression
- Documentation: Added notes about manual session invalidation and other known issues
- Translations: Updated Arabic, Dutch, Polish, Japanese, Chinese, French, German, and Italian
June 17, 2022¶
Build 220617-0402b8d3
This update features updated translations as well as fixes for recently discovered issues.
- Albums: A deleted album is restored when trying to add a new album with the same name
- WebDAV: Added support for auto indexing/importing in a sub-directory on a shared domain
- Translations: Updated Arabic, Czech, Korean, and Norwegian Bokmål
June 14, 2022¶
Build 220614-dea9ff68
A small but important update that includes translations to Arabic, a migration fix for MariaDB, and many updated dependencies.
- Security: Upgraded Go to v1.18.3, which includes TLS and validation fixes
- MariaDB: Removed migration that could corrupt photo descriptions in the index
- Translations: Added Arabic, updated Danish and Polish
May 28, 2022¶
Build 220528-efb5d710
This update includes translations that were recently contributed via translate.photoprism.app. Missing translations were added by us using DeepL and Google Translate. Native speakers are invited to help improve those if needed. Thank you very much!
- UX: Mobile toolbar menu has been redesigned and made accessible in public mode
- Themes: Gemstone and Raspberry have been updated
May 27, 2022¶
Build 220527-005770ca
This update improves navigation fonts and mobile submenu colors for light themes. We are also working to establish PhotoPrism+ as the name for our community membership and associated benefits. For this, sponsorship information in the app, on our website, on GitHub Sponsors and Patreon is gradually being updated.
- UX: Fixed light theme colors of mobile navigation submenu
- UX: Splash screen has been updated and no longer depends on admin theme
May 24, 2022¶
Build 220524-c76de0df
This service release fixes potential issues with our new Debian 12-based Docker image that shipped with the last update. These may have prevented users from deploying it without making changes to their environment. In our ongoing effort to improve usability and performance, we have also implemented a number of UX/UI optimizations, such as using the default operating system font instead of Google's Roboto.
- UX: Added submenu to mobile navigation toolbar
- UX: Updated splash screen information and animation
- UX: Numerous translations have been added and updated
- UX: Improved UI styles for right-to-left languages
- Auth: Short initial passwords are permitted again to avoid login problems
- Logs: Repeated log messages are omitted to prevent feedback loops
- Logs: Trace and debug messages are no longer displayed in the UI to avoid information leaks and reduce websocket communication overhead
- Search:
mono:true
filter now omits files with unknown chroma - Docker: Removed incorrect permission check for storage folder on startup
- Docker: Supported User and Group ID ranges have been documented
Thank you to everyone who helped with testing, signed up as a sponsor, or contributed in other ways! We appreciate it very much.
May 17, 2022¶
Build 220517-b9c68f8f
This update features search UX improvements, a new Docker base image based on Debian 12 "Bookworm", as well as fixes for recently discovered issues. Front- and backend translations in numerous languages have been added and updated. Thanks to all involved!
- File Formats: Added native support for WebP images and animated GIFs
- UX: RAW files are skipped by default when downloading photos and ZIP archives
- Auth: Passwords must have at least 8 characters to mitigate brute-force attacks
- Search: User interface and database performance optimizations
- Search: Fixed occasional lag when entering queries in the search toolbar
- Search: Improved
album:...
filter supports numeric names,albums:..
also AND/OR - Search: Improved
camera:...
andlens:...
filters accept names in addition to IDs - Search: Added
square:yes
andlandscape:yes
filters - Albums: "Add to album" dialog preloads more names for auto-completion
- Albums: Album names are shortened if necessary to avoid errors when saving
- Albums: Fixed accidental creation of duplicates by pressing Enter multiple times
- People: Improved logging and fixed potential issues with matching unrecognized faces
- Places: Number of pictures rendered on the map has been limited to 500,000
- Library: Added button to clear log history in Library > Errors
- Library: RAW previews and the number of actual files are shown under Originals
- Library: Disabled hidden files warning while indexing as it can be misleading
- Index: Fixed errors when re-indexing libraries with archived photos
- Index: RAW and video conversion commands run in a virtual home directory
- Thumbnails: Reduced default JPEG quality from 92 to 85 to optimize storage and loading
- Metadata: Manual local time changes are always preserved when reindexing
- Metadata: Fixed Exif orientation flag when converting HEIF/HEIC images to JPEG
- Metadata: Fault-tolerant parsing of timestamps from Exif and JSON sidecar files
- Metadata: Improved parsing of two-digit years in original file paths
- Metadata: Exif IFD1 tags with existing IFD0 values are ignored to improve standard compliance
- Metadata: Brute-force search is skipped by default if no Exif headers were found in JPEG, PNG, TIFF, and HEIF files
- Metadata: SubSecDateTimeOriginal and SubSecCreateDate timestamps are preferred
- WebDAV: Up- and download sync can no longer be enabled at the same time to prevent unexpected behavior
- WebDAV: Added timeout/retry settings and improved handling of sync errors
- WebDAV: Fixed sharing videos and uploading automatically created albums
- CLI: Renamed
--config-file
to--defaults-yaml
and improved command help - CLI: Added short names for common config flags, e.g.
-i
for--wakeup-interval
- CLI: Run
photoprism show tags
to display metadata tags and supported standards - CLI: Run
photoprism show formats
to display supported media and sidecar file formats - CLI: Run
photoprism show filters
to display a search filter overview with examples - Config: Improved FFmpeg parameters for Intel QSV hardware transcoding
- Config: Added NVIDIA hardware video transcoding support for sponsors
- Config: Added
--disable-raw
flag to disable indexing and conversion of RAW files - Config: Added
--resolution-limit
option to skip high-resolution images when indexing - Docker: New Debian 12 "Bookworm" base image with FFmpeg 4.4.1 and Darktable 3.8.1
- Docker: Added default users and groups for enhanced video transcoding compatibility
- Translations: Added Swedish, Romanian, Turkish, Lithuanian, Bulgarian, Malay, and Croatian
March 2, 2022¶
Build 220302-0059f429
The Docker images for this release are based on Debian 11 "Bullseye" and include many updated dependencies such as Darktable 3.8. Behind the scenes, the build process has also been improved so that it will be easier to provide standalone packages in the future.
- Auth: New login screen with more space for buttons, links, and legal information
- Metadata: Redesigned file details tab in the edit dialog
- Metadata: Support for Zulu formatted timestamps in Exiftool JSON and XMP
- Sharing: Fixed upload of complete albums via WebDAV
- Sharing: Manual WebDAV upload of video and RAW files
- iOS: Fixed multi-select via long touch in Safari PWA mode
- API: Added cache control header for faster thumbnail loading
- Config: Simplified configuration of Unix domain socket database connections
- Config: Added
--imprint
and--imprint-url
to display legal information in the footer - Docker: Automatic installation of compatible CPU and GPU drivers
- Translations: Updated all front- and backend locales
You can now join us on translate.photoprism.app to help translate the UI!
January 21, 2022¶
Build 220121-2b4c8e1f
We've generated missing translations with the help of DeepL and Google Translate. Native speakers are invited to help us improve those if needed. Learn how to contribute.
- Minimum memory requirements have been reduced to 3 GB
- Photos: Fixed buttons in full screen view
- People: Fixed typo that prevented face matching optimization
- Moments: Improved update performance on MariaDB
- Translations: Pre-translated missing UI messages
January 18, 2022¶
Build 220118-76c94a1f
- Auth: Logout redirects to base URI instead of site root
- Videos: Excluded streaming from gzip compression
- Videos: Fixed Content-Type header and streaming in Safari
- Folders: Fixed search query string substitutions and sanitation
- UI: Updated information and links in Settings > About
- UI: Improved bootstrap template rendering performance
January 7, 2022¶
Build 220107-f5b7ef83
Based on our zero bug policy, this update focuses on bug fixes, security, and UX improvements for search filters, metadata, and the indexer. In addition, one of the merged pull requests may improve face recognition performance on smaller devices and with large libraries.
- People: Improved update performance on MariaDB
- People: Improved contrast of person selection menu
- Albums: Private pictures are excluded from download as zip
- Search: Improved query parser for additional security
- Search: Added
uid:...
search filter to find photos by uid - Search:
keywords:...
filter does not exclude stopwords anymore - Index: Original filenames can be extracted from Exiftool JSON
- Index: More accurate and resilient handling of related files and photo stacks
- Live Photos: HEIF is used to create primary JPEG instead of a MOV still image
- Metadata: Reduced log level for missing Exif data from warn to info
- Metadata: Increased size of projection and color profile fields to 40 characters
- Backups: Improved help for config options and CLI commands
- Help: Fixed reverse proxy documentation links
- Config: Added Apple Video Toolbox hardware transcoding support for macOS
- Config: Added
/opt/photoprism
to search path for asset and storage folders
December 15, 2021¶
Build 211215-93b26f19
PhotoPrism is not directly affected by the Apache Log4j vulnerability. Logs may still contain messages that can cause harm if consumed by an unpatched Java application. As a precaution, this release includes additional rules and filters to validate user input.
- Sharing: Fixed album link redirect on shared domains
- Import: More helpful warning when another import is already running
- Docker: ARMv7 image for 32-bit processors and operating systems
December 10, 2021¶
Build 211210-2cb90e7e
Starting with this release, the regular multi-arch Docker image is 64-bit only. A 32-bit version of our stable release for older devices is offered separately. This frees up development and infrastructure resources with minimal impact.
- Security: Upgraded Go to v1.17.5, which includes HTTP/2 and networking fixes
- People: Concurrent updates are no longer possible to prevent inconsistencies
- Places: Additional logs to detect invalid GPS coordinates in metadata
- SQLite: Reduced routine maintenance log levels and fixed migration warnings
- Thumbnails: Apple Display P3 profile support for more accurate colors
- Translations: Updated French
December 3, 2021¶
Build 211203-fdb6b5e1
Since the funding goal required to make all features and maps generally available has not been reached, early-access features have been renamed to sponsor features in this update. Offline and high-resolution street maps remain free for everyone, while hybrid, topographic, and outdoor maps are now a sponsor feature. We believe this is fair. A big thank you to all our sponsors and contributors!
- CLI: Improved parameter and command descriptions
- CLI: Reset command optionally also deletes files in the cache folder
- Config: Improved
docker-compose.yml
examples
November 30, 2021¶
Build 211130-13cfcf6d
- Videos: Live photos page has been added to the sub-navigation
- Albums: Manually created albums are sorted by name, with favorites first
- Places: Improved location details in border regions and near Paris
- PWA: Updated app icons, style is now also applied to the user interface
For our sponsors and contributors:
- UI: New Abyss and Gemstone dark themes 💎
November 28, 2021¶
Build 211128-7e8974fd
Official support for MySQL 8 is discontinued with this update as Oracle seems to have stopped shipping new features and improvements. As a result, the testing effort required before each release is no longer feasible. We recommend upgrading to MariaDB 10.6 or later. PostgreSQL support is planned for 2022 without a specific release date yet.
November 27, 2021¶
Build 211127-86c43159
When possible, location estimates now include a latitude and longitude. Photos load faster when you open them in Places, and the viewer sorts them by distance. Time zone handling has been completely reworked, in particular for UTC. The Docker base image has been upgraded to Ubuntu 21.10, which ships with Darktable 3.6 among other updated dependencies.
- UX: Redesigned splash screen based on theme colors
- Places: Viewer loads faster and sorts photos by distance instead of date
- Places: Less frequent estimates to reduce background activity
- Places: Normalized names of states, oceans, and lakes
- Places: Updated location data from OpenStreetMap
- Places: State albums are grouped by country name
- Folders: Path names are searched in addition to titles
- People: Improved face detection performance
- People: Fixed naming faces in non-primary files
- People: Optimized matching of children's faces
- RAW: Upgraded Darktable to 3.6.0
- Metadata: Improved estimates and UTC time zone handling
- Metadata: Altitude is indexed even if coordinates are missing
- Auth: Usernames are not case-sensitive anymore
- CLI: Added
--force
flag tophotoprism optimize
command - CLI: Improved parameter and command descriptions
- Config: Improved
docker-compose.yml
examples - Translations: Added Bahasa Indonesia and Hungarian
- Translations: Updated Polish and Italian
For our sponsors and contributors:
- CLI: Run
photoprism places update
to retrieve updated location details - Config: Set
PHOTOPRISM_APP_ICON
to choose an alternative PWA icon
October 18, 2021¶
Build 211018-e200f322
- UI: Updated Lavender theme
- Places: Fixed maps initialization after reload in non-public mode
- Search: Added
live
andraw:true
filters as alternative totype:…
- Search: Added
faces:new
alias forface:new
- Config: Maximum background worker interval has been increased to 7 days
- Security: Added
Content-Security-Policy
header to prevent framing attacks - Translations: Updated Russian and Slovak
For our sponsors and contributors:
- UI: New Vanta dark theme ✨
October 10, 2021¶
Build 211010-83b4f783
- Translations: Fixed German frontend typo
- Translations: Updated all backend locales
We've generated missing translations with the help of DeepL and Google Translate. Native speakers are invited to help us improve those if needed. Learn how to contribute.
October 9, 2021¶
Build 211009-d6cc8df5`
- UX: Improved wording of search result notifications
- UX: Fixed sidebar navigation on small screens
- Users: Show name and email in sidebar navigation
- Folders: Directory names listed in .ppignore are ignored
- Config: Allows bypassing low memory suggestion
- Docs: Updated about page
- Translations: Updated all frontend locales
October 7, 2021¶
Build 211007-8f55d6f8
- People: Improved stability and performance of new faces overview page
- Index: Duplicate error logs caused by broken JPEG files have been removed
- UX: Enhanced visibility of file errors in the edit dialog files tab
- CLI: Revised descriptions of commands and configuration flags
For our sponsors and contributors:
October 2, 2021¶
Build 211002-bf015326
- People: Enhanced UI / UX for renaming and merging faces
- People: Improved face detection accuracy
- Labels: Improved photo count accuracy
- Covers: Thumbnails load and update faster
- Search: Finds titles when query is too short for full-text index
- Search:
name:…
filter ignores path and extension - Videos: Optional Intel GPU hardware transcoding support
- Index: Automatic cleanup of orphaned file entries
- Logs: Updated log messages for improved readability
- Translations: Updated German and French
- Docker: Simplified installation of TensorFlow with AVX / AVX2 support
- Docker: Entrypoint script uses prefixed environment variables,
UID
andGID
are deprecated
September 25, 2021¶
Build 210925-96168e4b
- Recognizes faces so that specific people can be found
- UX: Improved UI design, navigation, and wording
- Search: Omit full-text index if query is too short
- Search: Added
keywords:…
,subjects:…
, andalbums:…
filters - Places: Internationalized maps incl RTL support
- Labels: Added photo counts to overview page
- Albums: Fixed share expiration date in form label
- Calendar: Empty month albums are hidden
- Viewer: Photos will be updated when search filters change
- Index: Ignore Synology
@eaDir
folders - Import: Ignore dot files listed in
.ppignore
- Upload: Added more detailed error logs
- Videos: Skip related images when downloading
- Videos: Added .mp as known MP4 file extension
- Videos: Default to UTC as metadata time zone
- Exiftool: Enabled large file support
- Metadata: Improved Exif parser with cycle detection
- Metadata: Support for long projection type names like transverse-cylindrical
- Config: Added RAW file extension blacklists for Darktable and RawTherapee
- Config: Added disable options for image classification and facial recognition
- Config: Added support for non-root site URLs
- Config: Added content delivery network URL option
- MariaDB: Set explicit table engine, charset, and collation
- MariaDB: Added log message for old versions with broken table name resolution
- Docker: Added
HOME
env for Darktable & RawTherapee - Docker: Single multi-arch image for AMD64, ARM64, and ARMv7
May 23, 2021¶
Build 210523-b1856b9d
- RAW: Added RawTherapee flag to use existing sidecar files
- Import: Never remove ignored folders such as for Syncthing
May 20, 2021¶
Build 210520-4b32bac7
- Docker: Fixed home directory permissions in new base image
- HEIF: Test if JPEG was already rotated based on video metadata
May 19, 2021¶
Build 210519-24b5c7e6
- Metadata: Upgraded Exiftool to fix security issue
May 18, 2021¶
Build 210518-80981c25
- Safari: Fixed PWA file download on iOS
- Docker: Added config example for scheduled background tasks
- Docker: Updated base image includes Darktable 3.4.1, RawTherapee 5.8, and FFmpeg 4.3.2
- TensorFlow: Improved error handling
- Translations: Updated French
May 5, 2021¶
Build 210505-d3e53a89
- UI: Improved RTL (right-to-left language) alignment
- RAW: Added config options to disable specific converters
- Metadata: Preserve stopwords in existing keywords
- Metadata: Allow single quotes in keywords
- WebDAV: Keep favorite flag when uploading via PhotoSync
- Translations: Updated Dutch and German
April 26, 2021¶
Build 210426-da6e948f
- UI: Added Yellowstone theme for sponsors, unlocked Grayscale theme for everyone
- Metadata: Support for XMP sidecar CreateDate and Keywords
- Metadata: Merge keywords from different sources
- Translations: Updated Hebrew
April 22, 2021¶
Build 210422-97e75b04
- UX: Improved touch event accuracy
- UX: Optimized rendering on small screens
- UX: Fixed autocomplete in "add to album" dialog
- HEIF: Prevent redundant sidecar JPEG files
- Backup: Added command flags and usage docs
- Translations: Added Danish and Kurdish
February 22, 2021¶
Build 210222-ac5a9d5e
- UX: Autofocus for input fields and confirm on enter
- Restore: Find YAML album backups in originals folder
- Metadata: Improved location labels and moments
- Thumbnails: Fixed auto-rotation for HEIF, TIFF, and PNG images
- Translations: Added Norwegian (Bokmål)
February 17, 2021¶
Build 210217-49039368
- Videos: Optimized transcoding parameters
- Videos: Use AAC audio for MP4 transcoding
- Metadata: Default to landscape orientation if data is invalid
- Translations: Updated Brazilian Portuguese
February 16, 2021¶
Build 210216-4939e36a
- UX: Automatically hide scrollbar in photo viewer and Places
- Delete: Permanently remove all related sidecar files
- Videos: Added transcoding config options
- Videos: Added batch transcoding via convert command
- Metadata: Remove estimate when setting a new country
- Metadata: Workaround for Exif strings containing newlines
February 11, 2021¶
Build 210211-b9595dd4
- Videos: Native player featuring performance and UX improvements
- Index: Improved detection of missing photos, files, and folders
February 8, 2021¶
Build 210208-9e10ba69
- Upload: Adds duplicates to selected albums as well
- Library: Show folder covers in Originals
- Metadata: Automatically remove orphan countries, cameras, and lenses
- Metadata: Improved Exif parser
- Backup: Restore archive flag from YAML files
- Docker: Improved entrypoint script
January 28, 2021¶
Build 210128-a82061e0
- UX: Improved theme colors and icons
- UX: Download all related media files using their current name by default
- UX: Redirect already authenticated users from /login to /browse
- Mobile: Prevent like on touch swipe
- Translations: Updated German and French
- Config: Reduced auto index & import safety delay defaults
- Metadata: Improved photo titles, removed small words from title endings
- Metadata: Improved date extraction from current and original file names
- Metadata: Fallback to earliest file mod time in case there is no other date
- Import: Index keywords from non-primary filenames as well
- WebDAV: Improved service discovery
- Purge: Hide missing files in edit dialog and set new primary if needed
- Archive: Physically delete files after confirmation
- Moments: Added delete button to context menu
- Settings: Added Estimates and Delete feature flags
- CLI: Added cleanup command to remove orphaned index entries and thumbnails
January 21, 2021¶
Build 210121-07e559df
- UX: Improved video playback and icons
- UX: Restructured main navigation
- Mobile: Show search field in albums
January 20, 2021¶
Build 210120-e7cd5e9a
- API: Apply limit, offset and sort order when searching for IDs
- ARM64: Reverted database image back to arm64v8/mariadb in config example
January 19, 2021¶
Build 210119-a5399f06
- UX: Optimized user interface for iOS and tablets
- UX: Improved theme colors
- UX: Scroll position is restored when navigating back
- Translations: Added Czech
- Metadata: Estimate timezone and allow overwriting estimated locations
- Settings: Fixed disabling logs
For our sponsors and contributors:
- UX: Added two dark themes
January 11, 2021¶
Build 210111-cc05c430
- UX: Disabled preloading in live photo player to reduce memory footprint
- UX: Updated main navigation, find all media types via /browse
- UX: Removed lag when selecting pictures
- UX: Tweaked tile size breakpoints in Albums, Labels, and Search
- UX: Added tooltips to navigation expand and minimize buttons
- UX: Preload additional search results
- UX: Removed image loading spinners for faster rendering
- Thumbnails: Added cache control headers for improved performance
- Album Covers: Cache will be flushed after updating private flags
- Search: Improved performance of photos query
- PWA: Added service worker so that app can be installed more easily
- PWA: Enabled auto-rotate so that photos may be viewed in landscape mode
- Frontend: Removed unused dependencies and reduced build size
- Translations: Updated Russian, French, Simplified Chinese, and German
- Index: Automatically create JPEGs for related media files as well
- Import: Improved error handling when the file system becomes unavailable
- Config: Updated docker-compose.yml examples
- Config: Added optional gzip compression for built-in web server
- Config: Limit number of indexing workers to half the number of physical cores by default to avoid high load on hyper-threading capable CPUs
January 4, 2021¶
Build 210104-7f9e806a
- Config: Added auto index & import defaults to Dockerfiles
- Import: Extract metadata with ExifTool before moving
- Import: Automatically create folder albums
- Help: Updated WebSocket page
- UX: Added
UI.Zoom
setting to re-enable page zoom - UI: Updated default theme
- Translations: Added Hebrew & Japanese, updated Brazilian Portuguese
- Albums & Cards View: Reduced tile size on large screens
- WebDAV: Less verbose logging
January 2, 2021¶
Build 210102-af71e5f7
- WebDAV: Uploads and other changes trigger auto indexing / importing
- Config: Use random hash for improved preview token security
- UX: Disabled page zoom so that app feels more native on mobile devices
- UX: Reduced min password length to 4 characters
- UX: Improved docker-compose.yml examples
- UX: Reduced icon size in "add to album" dialog
December 31, 2020¶
Build 201231-8e22fbf8
- Initial Stable Release
Getting Updates¶
Even when you use an image with the :latest
tag, Docker does not automatically download new images for you. To update, you can either manually pull the most recent image and restart, or set up a service like Watchtower to get automatic updates.