Fixed

• Fixed #18: Calendar displays now include all-day events, currently running and multi-day events, and recurring event occurrences with the correct end time.
• Calendar searches now ignore VTODO entries from calendars that also contain task lists.
• Events using DURATION instead of DTEND are normalized before they reach the display.

Known limitation

• A currently running event can only be displayed if Nextcloud returns it for the requested timerange. If the calendar backend filters solely by DTSTART, an event that started before the timerange begins may not be returned even though its DTEND is still in the future.

• Fixed #14: Recurring event times were off by several hours because the timezone of expanded occurrences was ignored; times are now converted to unambiguous instants before reaching the display.

• Fixed: Saving settings failed with a 400 error because the refresh interval was sent as a number instead of a string.
• Changed: The media refresh interval field now only accepts whole minutes.

• Fixed #14: Recurring calendar entries are now included in the display.
• Fixed #15: Displays refresh their media list when files are added, removed, or changed; the interval is configurable in minutes.
• Upgrade note: Existing second-based values migrate automatically to minutes. API consumers must use imageRefreshIntervalMinutes.

Changed

• Nextcloud Weather integration (#10): Removed the redundant manual weather implementation and use the official Nextcloud Weather Status infrastructure and its weather API data and icons instead.
• Location configuration: Weather locations and temperature units are taken from the Nextcloud Weather Status settings. For displays that need a specific location, use a dedicated Nextcloud dashboard user with that location configured.
• Weather display: Show a compact daily forecast with official Weather Status icons, daily minimum and maximum temperatures, and locale-based Fahrenheit conversion.
• Clock layout: Refined the clock layout, including compact alignment of the AM/PM indicator to preserve space for the weather and calendar widgets.
• Code cleanup: Removed obsolete weather configuration, provider fallbacks, UI fields, translation entries and unused styling.

Added

• Widget selection (#6): Configure slideshow, weather, and calendar visibility independently per preset.
• Event descriptions per preset (#7): Choose independently for each preset whether calendar descriptions are displayed.
• Header title source: Choose the global display name, the preset name or no title per preset.
• Image prefetching: The next slideshow image is loaded in the background to reduce flickering and visible image buildup during transitions.
• Adaptive layouts: The public display adjusts its layout to the selected widgets, including asymmetric weather columns and full-height single-widget layouts.
• Backward-compatible preset migration: Existing presets receive all three widgets enabled by default.
• Calendar event descriptions: Added an opt-in setting to show sanitized event descriptions below calendar details.

Changed

• Responsive public display: Hidden widgets no longer leave loading placeholders or consume layout space.
• Preset summaries: The settings UI now shows which widgets are active for each preset.
• Asset cache handling: Updated display and settings assets are loaded with release cache-busting while preserving Nextcloud translations.
• Calendar layout protection: Event descriptions are limited to three visible lines to keep displays readable.

Technical

• Added preset fields show_slideshow, show_weather and show_calendar.
• Added preset field header_title_source with backward-compatible global, preset and none values.
• Added database migration Version1400Date20260815000000.
• Added database migration Version1500Date20260815000000 for per-preset event descriptions.
• Added database migration Version1600Date20260815000000 for per-preset header title sources.
• Added widget-aware layout combinations for desktop and portrait/mobile displays.
• Thanks to @FahrJo for the first contribution to the project in PR #5, which introduced image prefetching for smoother slideshow transitions.

Fixed

• Nextcloud 34 compatibility (#8): Replaced deprecated global server lookups with injected public APIs.
• Controller user ID injection: Renamed the deprecated UserId service alias to userId.
• Public display security values: Use Nextcloud-provided request tokens and CSP nonces in templates.
• Preset update state: Widget selections remain unchanged when an existing preset is updated.
• Hidden widget placeholders: Disabled widgets no longer show their initial loading messages.
• Responsive overflow: Prevented calendar content and mobile layouts from creating an oversized lower page margin.

Fixed

• Settings save error: Fixed JavaScript error that prevented saving settings due to reference to removed show_display_name checkbox element

Added

• Video support: Display MP4, WebM, MOV, and MKV video files in slideshows
• Videos play automatically and advance to the next item when finished
• Mix images and videos in the same folder seamlessly
• Native HTML5 video playback with muted autoplay
• Videos respect crop mode settings (fill/fit) using CSS object-fit
• Supported video formats: .mp4, .webm, .mov, .mkv
• Nextcloud 34 compatibility: Extended maximum supported version to Nextcloud 34

Changed

• UI terminology update: Replaced "Images" with "Media" throughout the interface to reflect video support

Technical

• Enhanced PublicApiController::getImages() to detect video file extensions and return type field (image or video)
• Rewritten display.js slideshow engine:
• Dynamic element creation (video elements vs. background images)
• Event-driven auto-advance for videos (ended, error events)
• Separate timing logic for images (interval-based) and videos (self-timed)
• Proper cleanup of video elements and timers on transition
• Added error handling to skip to next item if video fails to load
• Supported image formats (unchanged): .jpg, .jpeg, .png, .gif, .webp

Fixed

• Fixed #18: Calendar displays now include all-day events, currently running and multi-day events, and recurring event occurrences with the correct end time.
• Calendar searches now ignore VTODO entries from calendars that also contain task lists.
• Events using DURATION instead of DTEND are normalized before they reach the display.

Known limitation

• A currently running event can only be displayed if Nextcloud returns it for the requested timerange. If the calendar backend filters solely by DTSTART, an event that started before the timerange begins may not be returned even though its DTEND is still in the future.

• Fixed #14: Recurring event times were off by several hours because the timezone of expanded occurrences was ignored; times are now converted to unambiguous instants before reaching the display.

• Fixed: Saving settings failed with a 400 error because the refresh interval was sent as a number instead of a string.
• Changed: The media refresh interval field now only accepts whole minutes.

• Fixed #14: Recurring calendar entries are now included in the display.
• Fixed #15: Displays refresh their media list when files are added, removed, or changed; the interval is configurable in minutes.
• Upgrade note: Existing second-based values migrate automatically to minutes. API consumers must use imageRefreshIntervalMinutes.

Changed

• Nextcloud Weather integration (#10): Removed the redundant manual weather implementation and use the official Nextcloud Weather Status infrastructure and its weather API data and icons instead.
• Location configuration: Weather locations and temperature units are taken from the Nextcloud Weather Status settings. For displays that need a specific location, use a dedicated Nextcloud dashboard user with that location configured.
• Weather display: Show a compact daily forecast with official Weather Status icons, daily minimum and maximum temperatures, and locale-based Fahrenheit conversion.
• Clock layout: Refined the clock layout, including compact alignment of the AM/PM indicator to preserve space for the weather and calendar widgets.
• Code cleanup: Removed obsolete weather configuration, provider fallbacks, UI fields, translation entries and unused styling.

Added

• Widget selection (#6): Configure slideshow, weather, and calendar visibility independently per preset.
• Event descriptions per preset (#7): Choose independently for each preset whether calendar descriptions are displayed.
• Header title source: Choose the global display name, the preset name or no title per preset.
• Image prefetching: The next slideshow image is loaded in the background to reduce flickering and visible image buildup during transitions.
• Adaptive layouts: The public display adjusts its layout to the selected widgets, including asymmetric weather columns and full-height single-widget layouts.
• Backward-compatible preset migration: Existing presets receive all three widgets enabled by default.
• Calendar event descriptions: Added an opt-in setting to show sanitized event descriptions below calendar details.

Changed

• Responsive public display: Hidden widgets no longer leave loading placeholders or consume layout space.
• Preset summaries: The settings UI now shows which widgets are active for each preset.
• Asset cache handling: Updated display and settings assets are loaded with release cache-busting while preserving Nextcloud translations.
• Calendar layout protection: Event descriptions are limited to three visible lines to keep displays readable.

Technical

• Added preset fields show_slideshow, show_weather and show_calendar.
• Added preset field header_title_source with backward-compatible global, preset and none values.
• Added database migration Version1400Date20260815000000.
• Added database migration Version1500Date20260815000000 for per-preset event descriptions.
• Added database migration Version1600Date20260815000000 for per-preset header title sources.
• Added widget-aware layout combinations for desktop and portrait/mobile displays.
• Thanks to @FahrJo for the first contribution to the project in PR #5, which introduced image prefetching for smoother slideshow transitions.

Fixed

• Nextcloud 34 compatibility (#8): Replaced deprecated global server lookups with injected public APIs.
• Controller user ID injection: Renamed the deprecated UserId service alias to userId.
• Public display security values: Use Nextcloud-provided request tokens and CSP nonces in templates.
• Preset update state: Widget selections remain unchanged when an existing preset is updated.
• Hidden widget placeholders: Disabled widgets no longer show their initial loading messages.
• Responsive overflow: Prevented calendar content and mobile layouts from creating an oversized lower page margin.

Fixed

• Settings save error: Fixed JavaScript error that prevented saving settings due to reference to removed show_display_name checkbox element

Added

• Video support: Display MP4, WebM, MOV, and MKV video files in slideshows
• Videos play automatically and advance to the next item when finished
• Mix images and videos in the same folder seamlessly
• Native HTML5 video playback with muted autoplay
• Videos respect crop mode settings (fill/fit) using CSS object-fit
• Supported video formats: .mp4, .webm, .mov, .mkv
• Nextcloud 34 compatibility: Extended maximum supported version to Nextcloud 34

Changed

• UI terminology update: Replaced "Images" with "Media" throughout the interface to reflect video support

Technical

• Enhanced PublicApiController::getImages() to detect video file extensions and return type field (image or video)
• Rewritten display.js slideshow engine:
• Dynamic element creation (video elements vs. background images)
• Event-driven auto-advance for videos (ended, error events)
• Separate timing logic for images (interval-based) and videos (self-timed)
• Proper cleanup of video elements and timers on transition
• Added error handling to skip to next item if video fails to load
• Supported image formats (unchanged): .jpg, .jpeg, .png, .gif, .webp

Fixed

• Fixed #18: Calendar displays now include all-day events, currently running and multi-day events, and recurring event occurrences with the correct end time.
• Calendar searches now ignore VTODO entries from calendars that also contain task lists.
• Events using DURATION instead of DTEND are normalized before they reach the display.

Known limitation

• A currently running event can only be displayed if Nextcloud returns it for the requested timerange. If the calendar backend filters solely by DTSTART, an event that started before the timerange begins may not be returned even though its DTEND is still in the future.

• Fixed #14: Recurring event times were off by several hours because the timezone of expanded occurrences was ignored; times are now converted to unambiguous instants before reaching the display.

• Fixed: Saving settings failed with a 400 error because the refresh interval was sent as a number instead of a string.
• Changed: The media refresh interval field now only accepts whole minutes.

• Fixed #14: Recurring calendar entries are now included in the display.
• Fixed #15: Displays refresh their media list when files are added, removed, or changed; the interval is configurable in minutes.
• Upgrade note: Existing second-based values migrate automatically to minutes. API consumers must use imageRefreshIntervalMinutes.

Changed

• Nextcloud Weather integration (#10): Removed the redundant manual weather implementation and use the official Nextcloud Weather Status infrastructure and its weather API data and icons instead.
• Location configuration: Weather locations and temperature units are taken from the Nextcloud Weather Status settings. For displays that need a specific location, use a dedicated Nextcloud dashboard user with that location configured.
• Weather display: Show a compact daily forecast with official Weather Status icons, daily minimum and maximum temperatures, and locale-based Fahrenheit conversion.
• Clock layout: Refined the clock layout, including compact alignment of the AM/PM indicator to preserve space for the weather and calendar widgets.
• Code cleanup: Removed obsolete weather configuration, provider fallbacks, UI fields, translation entries and unused styling.

Added

• Widget selection (#6): Configure slideshow, weather, and calendar visibility independently per preset.
• Event descriptions per preset (#7): Choose independently for each preset whether calendar descriptions are displayed.
• Header title source: Choose the global display name, the preset name or no title per preset.
• Image prefetching: The next slideshow image is loaded in the background to reduce flickering and visible image buildup during transitions.
• Adaptive layouts: The public display adjusts its layout to the selected widgets, including asymmetric weather columns and full-height single-widget layouts.
• Backward-compatible preset migration: Existing presets receive all three widgets enabled by default.
• Calendar event descriptions: Added an opt-in setting to show sanitized event descriptions below calendar details.

Changed

• Responsive public display: Hidden widgets no longer leave loading placeholders or consume layout space.
• Preset summaries: The settings UI now shows which widgets are active for each preset.
• Asset cache handling: Updated display and settings assets are loaded with release cache-busting while preserving Nextcloud translations.
• Calendar layout protection: Event descriptions are limited to three visible lines to keep displays readable.

Technical

• Added preset fields show_slideshow, show_weather and show_calendar.
• Added preset field header_title_source with backward-compatible global, preset and none values.
• Added database migration Version1400Date20260815000000.
• Added database migration Version1500Date20260815000000 for per-preset event descriptions.
• Added database migration Version1600Date20260815000000 for per-preset header title sources.
• Added widget-aware layout combinations for desktop and portrait/mobile displays.
• Thanks to @FahrJo for the first contribution to the project in PR #5, which introduced image prefetching for smoother slideshow transitions.

Fixed

• Nextcloud 34 compatibility (#8): Replaced deprecated global server lookups with injected public APIs.
• Controller user ID injection: Renamed the deprecated UserId service alias to userId.
• Public display security values: Use Nextcloud-provided request tokens and CSP nonces in templates.
• Preset update state: Widget selections remain unchanged when an existing preset is updated.
• Hidden widget placeholders: Disabled widgets no longer show their initial loading messages.
• Responsive overflow: Prevented calendar content and mobile layouts from creating an oversized lower page margin.

Fixed

• Settings save error: Fixed JavaScript error that prevented saving settings due to reference to removed show_display_name checkbox element

Added

• Video support: Display MP4, WebM, MOV, and MKV video files in slideshows
• Videos play automatically and advance to the next item when finished
• Mix images and videos in the same folder seamlessly
• Native HTML5 video playback with muted autoplay
• Videos respect crop mode settings (fill/fit) using CSS object-fit
• Supported video formats: .mp4, .webm, .mov, .mkv
• Nextcloud 34 compatibility: Extended maximum supported version to Nextcloud 34

Changed

• UI terminology update: Replaced "Images" with "Media" throughout the interface to reflect video support

Technical

• Enhanced PublicApiController::getImages() to detect video file extensions and return type field (image or video)
• Rewritten display.js slideshow engine:
• Dynamic element creation (video elements vs. background images)
• Event-driven auto-advance for videos (ended, error events)
• Separate timing logic for images (interval-based) and videos (self-timed)
• Proper cleanup of video elements and timers on transition
• Added error handling to skip to next item if video fails to load
• Supported image formats (unchanged): .jpg, .jpeg, .png, .gif, .webp

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)
• Screenshot URLs in info.xml for proper App Store presentation
• Documentation links in info.xml for user and admin guides
• Enhanced app description with feature highlights and use cases

Changed

• Modernized app store description with emojis and better formatting

Fixed

• Removed incorrect <repair-steps> from info.xml (database migrations are auto-detected, not repair steps)

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)
• Screenshot URLs in info.xml for proper App Store presentation
• Documentation links in info.xml for user and admin guides
• Enhanced app description with feature highlights and use cases

Changed

• Fixed info.xml structure: <repair-steps> with <step> tags instead of deprecated <repair><steps><migration> structure
• Modernized app store description with emojis and better formatting

Changed

• Display name visibility setting moved from global app config to per-preset configuration
• Each preset can now independently control whether to show or hide the display name

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)

Fixed

• Fixed null pointer errors in fullscreen slideshow mode when weather or calendar elements are not present in the DOM
• Fullscreen slideshow mode no longer throws JavaScript errors when weather or calendar data fails to load

Fixed

• Migration index names were shortened to avoid MySQL/MariaDB identifier-length errors during schema updates.
• Locale fallback now resolves reliably to English for unsupported app languages.
• Fullscreen labels and prompt texts are now fully localized through the app l10n pipeline.

Added

• Spanish and Italian translation catalogs were added (es, it).

Added

• Per-text-class font size settings for display title, clock, weather and calendar content
• Style settings grouped into layout, colors and text sizes with dedicated reset actions
• Runtime font-size CSS variables so already open public displays can apply typography changes directly

Changed

• Default split layout width is now 50 percent for a balanced standard layout
• Layout wording in the settings UI was tightened and aligned with the remaining width-based configuration
• README and app metadata were refreshed for the current preset, layout and typography feature set

Fixed

• Resetting text sizes now restores the configured base defaults instead of legacy scaled values
• Legacy text-scaling paths and outdated translation strings were removed from settings, runtime config and API payloads
• The main settings header no longer uses an emoji label

Added

• Preset management for image and slideshow settings
• French translation updated and aligned with the current feature set
• Dutch translation added for the current feature set
• Separate view token and control token per display
• Remote preset switching through a public control API
• Per-display active preset assignment in the settings UI
• Playback order setting for presets with shuffle and filename order
• Display revision polling so public displays reload after remote changes
• Public config responses including active preset and revision information
• Configurable slideshow width percentage for the standard split layout
• Runtime application of layout changes on already open public displays
• New preset entity, mapper, service and controller
• New display config service to resolve effective settings from global config and active preset
• Database migrations for presets, control tokens, active preset assignment, revision tracking and image order mode
• Unit tests for presets and extended token handling

Changed

• The visible display title is now defined globally; display entries only use internal labels in the admin UI
• Image and slideshow settings were moved out of the global settings section into presets
• Public display rendering now uses the active preset for image folder, crop mode, interval, fullscreen slideshow mode and playback order
• The settings UI now distinguishes global settings, slideshow presets and displays more clearly
• The settings UI now uses a more consistent layout, title treatment and translation coverage

Fixed

• JSON error handling for preset requests now returns readable API errors instead of HTML fallbacks
• Broken or missing preset image order values are normalized automatically
• Localization files for German and English were repaired after malformed prefixes caused translation fallback issues
• Display slideshow behavior now supports stable sequential playback by filename and reshuffled playback cycles
• Invalid translation JSON files were repaired so server-side localization works reliably again
• Missing translations for display-management texts were added to English and German catalogs

Added

• Fullscreen toggle button integrated into display header
• Optional auto-prompt for fullscreen mode on page load (configurable setting)
• Chrome/Safari compatibility with webkit fullscreen API prefixes
• Internationalized fullscreen dialog using Nextcloud user language
• Auto-hide functionality for fullscreen button with mouse movement detection

Added

• Autocomplete for event exclusion based on actual calendar event titles
• Customizable display colors (Primary, Background, Text, Gradient Start/End)
• Toggle to show/hide display name on screen

Changed

• Metadata clean up

Added

• Small thumbnail for main screenshot (App Store preview loads faster)
• Further screenshots for app store

Added

• Automated and API-compliant App Store upload via GitHub Actions
• Nightly/pre-release support for App Store uploads
• PNG screenshots optimized and added to app description

Changed

• Internal scripts and obsolete files removed from release package
• Build and signing process improved and documented

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Added

• Initial public release for Nextcloud App Store

Fixed

• Fixed #18: Calendar displays now include all-day events, currently running and multi-day events, and recurring event occurrences with the correct end time.
• Calendar searches now ignore VTODO entries from calendars that also contain task lists.
• Events using DURATION instead of DTEND are normalized before they reach the display.

Known limitation

• A currently running event can only be displayed if Nextcloud returns it for the requested timerange. If the calendar backend filters solely by DTSTART, an event that started before the timerange begins may not be returned even though its DTEND is still in the future.

• Fixed #14: Recurring event times were off by several hours because the timezone of expanded occurrences was ignored; times are now converted to unambiguous instants before reaching the display.

• Fixed: Saving settings failed with a 400 error because the refresh interval was sent as a number instead of a string.
• Changed: The media refresh interval field now only accepts whole minutes.

• Fixed #14: Recurring calendar entries are now included in the display.
• Fixed #15: Displays refresh their media list when files are added, removed, or changed; the interval is configurable in minutes.
• Upgrade note: Existing second-based values migrate automatically to minutes. API consumers must use imageRefreshIntervalMinutes.

Changed

• Nextcloud Weather integration (#10): Removed the redundant manual weather implementation and use the official Nextcloud Weather Status infrastructure and its weather API data and icons instead.
• Location configuration: Weather locations and temperature units are taken from the Nextcloud Weather Status settings. For displays that need a specific location, use a dedicated Nextcloud dashboard user with that location configured.
• Weather display: Show a compact daily forecast with official Weather Status icons, daily minimum and maximum temperatures, and locale-based Fahrenheit conversion.
• Clock layout: Refined the clock layout, including compact alignment of the AM/PM indicator to preserve space for the weather and calendar widgets.
• Code cleanup: Removed obsolete weather configuration, provider fallbacks, UI fields, translation entries and unused styling.

Added

• Widget selection (#6): Configure slideshow, weather, and calendar visibility independently per preset.
• Event descriptions per preset (#7): Choose independently for each preset whether calendar descriptions are displayed.
• Header title source: Choose the global display name, the preset name or no title per preset.
• Image prefetching: The next slideshow image is loaded in the background to reduce flickering and visible image buildup during transitions.
• Adaptive layouts: The public display adjusts its layout to the selected widgets, including asymmetric weather columns and full-height single-widget layouts.
• Backward-compatible preset migration: Existing presets receive all three widgets enabled by default.
• Calendar event descriptions: Added an opt-in setting to show sanitized event descriptions below calendar details.

Changed

• Responsive public display: Hidden widgets no longer leave loading placeholders or consume layout space.
• Preset summaries: The settings UI now shows which widgets are active for each preset.
• Asset cache handling: Updated display and settings assets are loaded with release cache-busting while preserving Nextcloud translations.
• Calendar layout protection: Event descriptions are limited to three visible lines to keep displays readable.

Technical

• Added preset fields show_slideshow, show_weather and show_calendar.
• Added preset field header_title_source with backward-compatible global, preset and none values.
• Added database migration Version1400Date20260815000000.
• Added database migration Version1500Date20260815000000 for per-preset event descriptions.
• Added database migration Version1600Date20260815000000 for per-preset header title sources.
• Added widget-aware layout combinations for desktop and portrait/mobile displays.
• Thanks to @FahrJo for the first contribution to the project in PR #5, which introduced image prefetching for smoother slideshow transitions.

Fixed

• Nextcloud 34 compatibility (#8): Replaced deprecated global server lookups with injected public APIs.
• Controller user ID injection: Renamed the deprecated UserId service alias to userId.
• Public display security values: Use Nextcloud-provided request tokens and CSP nonces in templates.
• Preset update state: Widget selections remain unchanged when an existing preset is updated.
• Hidden widget placeholders: Disabled widgets no longer show their initial loading messages.
• Responsive overflow: Prevented calendar content and mobile layouts from creating an oversized lower page margin.

Fixed

• Settings save error: Fixed JavaScript error that prevented saving settings due to reference to removed show_display_name checkbox element

Added

• Video support: Display MP4, WebM, MOV, and MKV video files in slideshows
• Videos play automatically and advance to the next item when finished
• Mix images and videos in the same folder seamlessly
• Native HTML5 video playback with muted autoplay
• Videos respect crop mode settings (fill/fit) using CSS object-fit
• Supported video formats: .mp4, .webm, .mov, .mkv
• Nextcloud 34 compatibility: Extended maximum supported version to Nextcloud 34

Changed

• UI terminology update: Replaced "Images" with "Media" throughout the interface to reflect video support

Technical

• Enhanced PublicApiController::getImages() to detect video file extensions and return type field (image or video)
• Rewritten display.js slideshow engine:
• Dynamic element creation (video elements vs. background images)
• Event-driven auto-advance for videos (ended, error events)
• Separate timing logic for images (interval-based) and videos (self-timed)
• Proper cleanup of video elements and timers on transition
• Added error handling to skip to next item if video fails to load
• Supported image formats (unchanged): .jpg, .jpeg, .png, .gif, .webp

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)
• Screenshot URLs in info.xml for proper App Store presentation
• Documentation links in info.xml for user and admin guides
• Enhanced app description with feature highlights and use cases

Changed

• Modernized app store description with emojis and better formatting

Fixed

• Removed incorrect <repair-steps> from info.xml (database migrations are auto-detected, not repair steps)

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)
• Screenshot URLs in info.xml for proper App Store presentation
• Documentation links in info.xml for user and admin guides
• Enhanced app description with feature highlights and use cases

Changed

• Fixed info.xml structure: <repair-steps> with <step> tags instead of deprecated <repair><steps><migration> structure
• Modernized app store description with emojis and better formatting

Changed

• Display name visibility setting moved from global app config to per-preset configuration
• Each preset can now independently control whether to show or hide the display name

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)

Fixed

• Fixed null pointer errors in fullscreen slideshow mode when weather or calendar elements are not present in the DOM
• Fullscreen slideshow mode no longer throws JavaScript errors when weather or calendar data fails to load

Fixed

• Migration index names were shortened to avoid MySQL/MariaDB identifier-length errors during schema updates.
• Locale fallback now resolves reliably to English for unsupported app languages.
• Fullscreen labels and prompt texts are now fully localized through the app l10n pipeline.

Added

• Spanish and Italian translation catalogs were added (es, it).

Added

• Per-text-class font size settings for display title, clock, weather and calendar content
• Style settings grouped into layout, colors and text sizes with dedicated reset actions
• Runtime font-size CSS variables so already open public displays can apply typography changes directly

Changed

• Default split layout width is now 50 percent for a balanced standard layout
• Layout wording in the settings UI was tightened and aligned with the remaining width-based configuration
• README and app metadata were refreshed for the current preset, layout and typography feature set

Fixed

• Resetting text sizes now restores the configured base defaults instead of legacy scaled values
• Legacy text-scaling paths and outdated translation strings were removed from settings, runtime config and API payloads
• The main settings header no longer uses an emoji label

Added

• Preset management for image and slideshow settings
• French translation updated and aligned with the current feature set
• Dutch translation added for the current feature set
• Separate view token and control token per display
• Remote preset switching through a public control API
• Per-display active preset assignment in the settings UI
• Playback order setting for presets with shuffle and filename order
• Display revision polling so public displays reload after remote changes
• Public config responses including active preset and revision information
• Configurable slideshow width percentage for the standard split layout
• Runtime application of layout changes on already open public displays
• New preset entity, mapper, service and controller
• New display config service to resolve effective settings from global config and active preset
• Database migrations for presets, control tokens, active preset assignment, revision tracking and image order mode
• Unit tests for presets and extended token handling

Changed

• The visible display title is now defined globally; display entries only use internal labels in the admin UI
• Image and slideshow settings were moved out of the global settings section into presets
• Public display rendering now uses the active preset for image folder, crop mode, interval, fullscreen slideshow mode and playback order
• The settings UI now distinguishes global settings, slideshow presets and displays more clearly
• The settings UI now uses a more consistent layout, title treatment and translation coverage

Fixed

• JSON error handling for preset requests now returns readable API errors instead of HTML fallbacks
• Broken or missing preset image order values are normalized automatically
• Localization files for German and English were repaired after malformed prefixes caused translation fallback issues
• Display slideshow behavior now supports stable sequential playback by filename and reshuffled playback cycles
• Invalid translation JSON files were repaired so server-side localization works reliably again
• Missing translations for display-management texts were added to English and German catalogs

Added

• Fullscreen toggle button integrated into display header
• Optional auto-prompt for fullscreen mode on page load (configurable setting)
• Chrome/Safari compatibility with webkit fullscreen API prefixes
• Internationalized fullscreen dialog using Nextcloud user language
• Auto-hide functionality for fullscreen button with mouse movement detection

Added

• Autocomplete for event exclusion based on actual calendar event titles
• Customizable display colors (Primary, Background, Text, Gradient Start/End)
• Toggle to show/hide display name on screen

Changed

• Metadata clean up

Added

• Small thumbnail for main screenshot (App Store preview loads faster)
• Further screenshots for app store

Added

• Automated and API-compliant App Store upload via GitHub Actions
• Nightly/pre-release support for App Store uploads
• PNG screenshots optimized and added to app description

Changed

• Internal scripts and obsolete files removed from release package
• Build and signing process improved and documented

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Added

• Initial public release for Nextcloud App Store

Fixed

• Fixed #18: Calendar displays now include all-day events, currently running and multi-day events, and recurring event occurrences with the correct end time.
• Calendar searches now ignore VTODO entries from calendars that also contain task lists.
• Events using DURATION instead of DTEND are normalized before they reach the display.

Known limitation

• A currently running event can only be displayed if Nextcloud returns it for the requested timerange. If the calendar backend filters solely by DTSTART, an event that started before the timerange begins may not be returned even though its DTEND is still in the future.

• Fixed #14: Recurring event times were off by several hours because the timezone of expanded occurrences was ignored; times are now converted to unambiguous instants before reaching the display.

• Fixed: Saving settings failed with a 400 error because the refresh interval was sent as a number instead of a string.
• Changed: The media refresh interval field now only accepts whole minutes.

• Fixed #14: Recurring calendar entries are now included in the display.
• Fixed #15: Displays refresh their media list when files are added, removed, or changed; the interval is configurable in minutes.
• Upgrade note: Existing second-based values migrate automatically to minutes. API consumers must use imageRefreshIntervalMinutes.

Changed

• Nextcloud Weather integration (#10): Removed the redundant manual weather implementation and use the official Nextcloud Weather Status infrastructure and its weather API data and icons instead.
• Location configuration: Weather locations and temperature units are taken from the Nextcloud Weather Status settings. For displays that need a specific location, use a dedicated Nextcloud dashboard user with that location configured.
• Weather display: Show a compact daily forecast with official Weather Status icons, daily minimum and maximum temperatures, and locale-based Fahrenheit conversion.
• Clock layout: Refined the clock layout, including compact alignment of the AM/PM indicator to preserve space for the weather and calendar widgets.
• Code cleanup: Removed obsolete weather configuration, provider fallbacks, UI fields, translation entries and unused styling.

Added

• Widget selection (#6): Configure slideshow, weather, and calendar visibility independently per preset.
• Event descriptions per preset (#7): Choose independently for each preset whether calendar descriptions are displayed.
• Header title source: Choose the global display name, the preset name or no title per preset.
• Image prefetching: The next slideshow image is loaded in the background to reduce flickering and visible image buildup during transitions.
• Adaptive layouts: The public display adjusts its layout to the selected widgets, including asymmetric weather columns and full-height single-widget layouts.
• Backward-compatible preset migration: Existing presets receive all three widgets enabled by default.
• Calendar event descriptions: Added an opt-in setting to show sanitized event descriptions below calendar details.

Changed

• Responsive public display: Hidden widgets no longer leave loading placeholders or consume layout space.
• Preset summaries: The settings UI now shows which widgets are active for each preset.
• Asset cache handling: Updated display and settings assets are loaded with release cache-busting while preserving Nextcloud translations.
• Calendar layout protection: Event descriptions are limited to three visible lines to keep displays readable.

Technical

• Added preset fields show_slideshow, show_weather and show_calendar.
• Added preset field header_title_source with backward-compatible global, preset and none values.
• Added database migration Version1400Date20260815000000.
• Added database migration Version1500Date20260815000000 for per-preset event descriptions.
• Added database migration Version1600Date20260815000000 for per-preset header title sources.
• Added widget-aware layout combinations for desktop and portrait/mobile displays.
• Thanks to @FahrJo for the first contribution to the project in PR #5, which introduced image prefetching for smoother slideshow transitions.

Fixed

• Nextcloud 34 compatibility (#8): Replaced deprecated global server lookups with injected public APIs.
• Controller user ID injection: Renamed the deprecated UserId service alias to userId.
• Public display security values: Use Nextcloud-provided request tokens and CSP nonces in templates.
• Preset update state: Widget selections remain unchanged when an existing preset is updated.
• Hidden widget placeholders: Disabled widgets no longer show their initial loading messages.
• Responsive overflow: Prevented calendar content and mobile layouts from creating an oversized lower page margin.

Fixed

• Settings save error: Fixed JavaScript error that prevented saving settings due to reference to removed show_display_name checkbox element

Added

• Video support: Display MP4, WebM, MOV, and MKV video files in slideshows
• Videos play automatically and advance to the next item when finished
• Mix images and videos in the same folder seamlessly
• Native HTML5 video playback with muted autoplay
• Videos respect crop mode settings (fill/fit) using CSS object-fit
• Supported video formats: .mp4, .webm, .mov, .mkv
• Nextcloud 34 compatibility: Extended maximum supported version to Nextcloud 34

Changed

• UI terminology update: Replaced "Images" with "Media" throughout the interface to reflect video support

Technical

• Enhanced PublicApiController::getImages() to detect video file extensions and return type field (image or video)
• Rewritten display.js slideshow engine:
• Dynamic element creation (video elements vs. background images)
• Event-driven auto-advance for videos (ended, error events)
• Separate timing logic for images (interval-based) and videos (self-timed)
• Proper cleanup of video elements and timers on transition
• Added error handling to skip to next item if video fails to load
• Supported image formats (unchanged): .jpg, .jpeg, .png, .gif, .webp

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)
• Screenshot URLs in info.xml for proper App Store presentation
• Documentation links in info.xml for user and admin guides
• Enhanced app description with feature highlights and use cases

Changed

• Modernized app store description with emojis and better formatting

Fixed

• Removed incorrect <repair-steps> from info.xml (database migrations are auto-detected, not repair steps)

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)
• Screenshot URLs in info.xml for proper App Store presentation
• Documentation links in info.xml for user and admin guides
• Enhanced app description with feature highlights and use cases

Changed

• Fixed info.xml structure: <repair-steps> with <step> tags instead of deprecated <repair><steps><migration> structure
• Modernized app store description with emojis and better formatting

Changed

• Display name visibility setting moved from global app config to per-preset configuration
• Each preset can now independently control whether to show or hide the display name

Added

• German formal variant (de_DE) for formal "Sie" address form alongside informal "du" variant (de)

Fixed

• Fixed null pointer errors in fullscreen slideshow mode when weather or calendar elements are not present in the DOM
• Fullscreen slideshow mode no longer throws JavaScript errors when weather or calendar data fails to load