3D Viewer - Releases

Added

• Personal Settings: Added personal settings page for user-specific preferences
• SettingsController and PersonalSettings view for managing user preferences
• Settings routes and configuration updates
• Enhanced File Loaders: Significantly improved loader capabilities
• Enhanced FBX loader with additional features and better support
• Improved VRML loader with expanded capabilities
• Updated DAE loader for better compatibility
• Enhanced multi-file loading helpers for improved dependency resolution

Changed

• Viewer Enhancements: Enhanced ThreeViewer component with improved controls and features
• Camera Improvements: Updated camera composable with additional functionality
• Circular Controller: Enhanced circular controller with better user experience
• Theme and Performance: Updated theme and performance composables
• Major Version Bump: Version 2.0.0 introduces significant improvements and new features

Technical

• Updated GitHub workflows with improved condition syntax
• Updated Dependabot timezone to Asia/Muscat
• Added change detection to prevent unnecessary PRs in workflows
• Updated stylelint to 16.26.1

Changed

• Dependencies: Updated development and runtime dependencies
• three: ^0.181.1 → ^0.181.2 (patch update)
• stylelint: ^16.25.0 → ^16.26.0 (dev)
• vite: ^7.2.2 → ^7.2.4 (dev)

Added

• AnycubicSlicer Support: Added integration for AnycubicSlicer with custom icon and URL scheme. (#52)
• Folder Exclusion: Added support for .no3d marker file to exclude specific folders from 3D file scanning.
• Hidden Folder Exclusion: Automatically exclude hidden folders (starting with .) from the file index.
• Temp File Cleanup: Implemented background job to automatically clean up .3dviewer_temp files older than 24 hours.

Fixed

• Layout Issue: Fixed white empty space when hiding the navigation sidebar by ensuring correct flexbox behavior and explicit slot usage.
• Viewer Resizing: Fixed 3D canvas visual resizing issue by syncing internal resolution with CSS dimensions (width: 100%).
• Slicer Icons: Fixed missing slicer icons by using the correct imagePath helper for asset URLs.
• "By Folder" Navigation: improved folder indexing logic to correctly build hierarchy and handle edge cases.
• Server Error: Resolved persistent preg_match error in PreviewManager by disabling unused app preview provider registration.

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"
• Migration Class Declaration: Fixed missing class declaration in migration file
• Added class Version010902Date20251116061241 extends SimpleMigrationStep declaration
• Resolves syntax error: "unexpected token \"public\", expecting end of file"
• Folder Path Length: Removed the 512-character limit by hashing folder paths for indexing
• Restored folder_path to TEXT and added a folder_path_hash column with a new migration
• Existing rows are backfilled automatically so deep folder structures continue to work

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"
• Migration Class Declaration: Fixed missing class declaration in migration file
• Added class Version010902Date20251116061241 extends SimpleMigrationStep declaration
• Resolves syntax error: "unexpected token \"public\", expecting end of file"

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"
• Migration Class Declaration: Fixed missing class declaration in migration file
• Added class Version010902Date20251116061241 extends SimpleMigrationStep declaration
• Resolves syntax error: "unexpected token \"public\", expecting end of file"

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"

Added

• Database-Backed File Indexing: New tv_file_index database table for fast folder, type, date, and favorites navigation
• Automatic indexing via filesystem event listeners (NodeCreated, NodeWritten, NodeDeleted)
• Manual reindexing via php occ threedviewer:index-files [userId] command or /apps/threedviewer/api/files/index endpoint
• Migration automatically creates the index table on upgrade
• Smart File Browser: Complete file navigation system with multiple view modes
• Viewer mode: Opens 3D viewer by default on app load
• Folders mode: Hierarchical folder navigation with recursive folder structure
• Type mode: Browse files grouped by extension (GLB, GLTF, OBJ, etc.)
• Date mode: Browse files organized by year and month
• Favorites mode: View all favorited 3D files using Nextcloud system tags
• Breadcrumb navigation for easy navigation back through folder/type/date hierarchies
• Consistent card-based UI for folders, types, dates, and files
• Per-User Configuration: Remembers user preferences via ConfigController
• Saves preferred sort mode (viewer/folders/type/date/favorites)
• Remembers last opened file ID for session persistence
• Mobile experience: automatically hides the circular 3D controller when the viewer detects a small/mobile viewport, preventing overlap with the canvas controls.

Changed

• Viewer opens by default on app load; the file browser now appears only when a user explicitly selects a navigation mode.
• GET /apps/threedviewer/api/files/list now serves hierarchical payloads from the database index (folders, types, dates, favorites) instead of scanning filesystem
• Supports includeDependencies=1 parameter to return all files including textures and nested subfolders for multi-file model loading
• Dramatically reduces filesystem scans and improves performance
• Navigation data is loaded lazily per sort mode and cached so switching between viewer and browser modes no longer blocks on loading every file upfront.
• File browser UI refinements:
• File cards now share the same compact layout as folder cards (consistent padding, thumbnail sizing, fonts, and grid spacing).
• Type view heading and breadcrumbs no longer show a leading dot (e.g. GLB instead of .GLB).
• Breadcrumb component now handles clicks directly via NcBreadcrumb to improve reliability.
• Remembered folder/type state is cleared when returning to the root via breadcrumbs to ensure a fresh reload.

Fixed

• Newly uploaded, edited, or deleted 3D files (and favorites) appear instantly in every navigation mode because the indexing listener reacts to filesystem events instead of relying on manual rescans.
• Root breadcrumb ("Home") navigation restores the folder list correctly, even after drilling into nested folders.
• Multi-file dependency loading:
• Backend listFiles now supports includeDependencies=1 to return every file (including textures) and nested subfolders.
• The dependency crawler recursively searches texture subdirectories so 3DS/FBX models with textured assets load successfully.
• Texture search now uses the updated backend response structure to avoid missing files and 404 fetches.

Technical

• Created lib/Db/FileIndex.php and lib/Db/FileIndexMapper.php for database operations
• Created lib/Service/FileIndexService.php for indexing logic
• Created lib/Listener/FileIndexListener.php for automatic index updates
• Created lib/Command/IndexFiles.php for manual reindexing command
• Created lib/Controller/ConfigController.php for user preference storage
• Created lib/Migration/Version010902Date20251116061241.php for database schema migration
• Created src/components/FileNavigation.vue and src/components/FileBrowser.vue for new navigation UI
• Updated lib/Controller/FileController.php with new listFiles() and indexFiles() endpoints

Added

• Preview Provider Implementation: Implemented Nextcloud IPreviewProvider interface for 3D model previews
• Admins can enable/disable via enabledPreviewProviders config in config/config.php
• Integrates with Nextcloud's native preview system
• When enabled, provider is registered and ready for future preview rendering implementation
• When disabled, Nextcloud automatically uses custom filetype SVG icons

Changed

• Updated dependencies:
• three: ^0.181.0 → ^0.181.1 (patch update)
• @nextcloud/router: ^3.0.1 → ^3.1.0 (minor update)
• vite: ^7.1.12 → ^7.2.2 (patch update)
• @nextcloud/browserslist-config: ^3.1.1 → ^3.1.2 (patch update)
• Improved duplicate registration prevention:
• Added guards to prevent duplicate file action registration
• Added guards to prevent duplicate viewer handler registration
• Enhanced error handling with try-catch blocks

Removed

• ThumbnailController: Removed custom thumbnail controller endpoint
• Replaced by proper Nextcloud IPreviewProvider implementation
• No longer needed as Nextcloud handles previews natively
• Thumbnail Placeholder: Removed dependency on thumbnail-placeholder.png
• Nextcloud automatically uses custom filetype icons when previews are disabled
• Custom icons already registered via mimetypemapping.json
• CSS Thumbnail Overrides: Removed CSS rules that forced app.svg background on thumbnails
• Allows Nextcloud's preview system to work properly
• Custom filetype icons display correctly when previews are unavailable

Fixed

• Duplicate Registration Warnings: Fixed console warnings about duplicate settings/registrations
• Added registration guards using window/globalThis flags
• Improved handler registration checks
• Better error handling for duplicate registrations

Technical

• Created lib/Preview/ModelPreviewProvider.php implementing IPreviewProvider
• Registered preview provider in Application.php bootstrap
• Removed THUMBNAIL endpoint from constants and API documentation
• Updated openapi.json with preview provider documentation

Added

• 🖨️ Slicer Integration: Send 3D models directly to slicer applications for 3D printing
• Support for PrusaSlicer, UltiMaker Cura, BambuStudio, OrcaSlicer, Simplify3D, and Eufy Studio
• One-click export with URL scheme integration
• Automatic STL conversion and temporary share link creation
• Professional slicer logos with brand-matched colors
• Last used slicer appears first for quick access
• Smart detection of uninstalled slicers with user-friendly error messages
• Auto-download fallback when slicer app is not registered
• Temporary file cleanup after 2 minutes
• Share links expire after 24 hours for security
• SlicerController API: Backend controller for handling slicer exports
• POST /api/slicer/temp - Upload STL and create temporary share link
• GET /api/slicer/temp/{fileId} - Download temporary file
• DELETE /api/slicer/temp/{fileId} - Delete temporary file and share
• Automatic cleanup of old temporary files
• Proper filename sanitization for paths and special characters
• CORS headers for slicer application compatibility

Changed

• Updated app version to 1.9.0
• Enhanced toolbar with "Send to Slicer" button
• Added slicer integration to slide-out tools panel
• Improved error handling with toast notifications
• Updated translations for all supported languages

Technical

• Created appinfo/routes.php for route registration
• Added @NoCSRFRequired annotations for API endpoints
• Implemented Nextcloud native share system for temporary URLs
• Fixed filename handling for files with paths and special characters
• Added proper authentication and cleanup mechanisms

Added

• Screenshot Feature: Capture high-quality screenshots of 3D models directly from the viewer
• PNG and JPEG format support with configurable quality
• Automatic filename generation with timestamp
• Accessible from toolbar and tools panel
• Download screenshots directly to local device
• Fixed WebGL renderer configuration to enable screenshot capture (preserveDrawingBuffer: true)
• Billboard Text Labels: Annotation and measurement text now always faces the camera
• Text remains readable from any viewing angle
• No more reversed/mirrored text when viewing from behind
• Smooth rotation as camera moves around the model
• Improved user experience for annotations and measurements

Changed

• Updated app version to 1.8.0
• Enhanced info.xml with new feature descriptions
• Updated English translations for screenshot and billboard features

Fixed

• CSP Conflicts: Removed global CSP listener that was breaking other Nextcloud apps (Memories, etc.)
• File Icons: Fixed custom file type icons not displaying by copying them to correct location
• App Compatibility: CSP modifications now only apply to 3D viewer routes, allowing other apps to function normally

Changed

• CSP headers now scoped to specific 3D viewer routes instead of globally
• Added automatic icon copying during build process (scripts/copy-icons.mjs)
• Removed lib/Listener/CspListener.php (no longer needed)

Fixed

• Viewer Integration: Fixed files() method not storing files list, causing "No files provided, skipping update" error
• File Loading: Fixed TypeError: Cannot read properties of undefined (reading 'filename') when opening 3D files
• Static Assets: Fixed 500 error when loading app-color.svg due to route conflicts
• Route Structure: Changed viewer route from /{fileId} to /f/{fileId} to prevent conflicts with static assets
• Axes Positioning: Axes helper now positioned at bottom center of models, aligned with grid
• Axes Scaling: Made axes size dynamic (25% of model's largest dimension, minimum 5 units)
• Logo Loading: Fixed app logo path in demo scene to use generateUrl() for correct URL resolution

Changed

• Enhanced files() method in ViewerComponent with fallback logic to create synthetic file from props
• Simplified PageController by removing unnecessary is_numeric() checks
• Updated URL structure for better RESTful design: /apps/threedviewer/f/{fileId}
• Axes now recreate on model load to ensure proper sizing and positioning

Fixed

• Viewer Integration: Fixed files() method not storing files list, causing "No files provided, skipping update" error
• File Loading: Fixed TypeError: Cannot read properties of undefined (reading 'filename') when opening 3D files
• Static Assets: Fixed 500 error when loading app-color.svg due to route conflicts
• Route Structure: Changed viewer route from /{fileId} to /f/{fileId} to prevent conflicts with static assets

Changed

• Enhanced files() method in ViewerComponent with fallback logic to create synthetic file from props
• Simplified PageController by removing unnecessary is_numeric() checks
• Updated URL structure for better RESTful design: /apps/threedviewer/f/{fileId}

Fixed

• Dark Theme Support: Fixed slide-out toolbar panel not responding to theme changes
• Theme Switching: Implemented reactive theme binding using Vue computed properties
• CSS Integration: Converted base styles to use Nextcloud CSS variables for better theme integration
• UI Consistency: Toolbar panel now properly switches between Light, Dark, and Auto themes

Changed

• Improved maintainability by using Nextcloud's standard color system throughout the toolbar
• Enhanced theme responsiveness with component-level class binding

Added

• 3D Camera Controller: New circular controller interface for intuitive 3D model navigation
• Camera Control Methods: Advanced camera manipulation including rotation, zoom, and directional nudging
• View Snapping: Animated camera transitions to predefined views (Front, Back, Left, Right, Top, Bottom)
• Controller Persistence: Save and restore controller position and visibility preferences
• Smooth Animations: Eased camera transitions with customizable duration and easing functions
• Face Labels: Orientation markers (TOP, BOTTOM, FRONT, BACK, LEFT, RIGHT) on model faces
• Export Functionality: Export models to GLB, STL, and OBJ formats
• Camera Projection Toggle: Switch between perspective and orthographic views
• Progressive Texture Loading: Background texture loading for improved performance
• Dependency Caching: IndexedDB caching system for faster multi-file model loading
• Model Statistics Panel: Detailed information about loaded models
• Help Panel: Comprehensive in-app documentation and controls guide
• Theme Customization: Enhanced theme switching with RTL support
• Performance Overlay: Visual performance stats display with real-time monitoring
• KTX2 Texture Support: GPU texture compression for better performance

Added

• Personal Settings: Added personal settings page for user-specific preferences
• SettingsController and PersonalSettings view for managing user preferences
• Settings routes and configuration updates
• Enhanced File Loaders: Significantly improved loader capabilities
• Enhanced FBX loader with additional features and better support
• Improved VRML loader with expanded capabilities
• Updated DAE loader for better compatibility
• Enhanced multi-file loading helpers for improved dependency resolution

Changed

• Viewer Enhancements: Enhanced ThreeViewer component with improved controls and features
• Camera Improvements: Updated camera composable with additional functionality
• Circular Controller: Enhanced circular controller with better user experience
• Theme and Performance: Updated theme and performance composables
• Major Version Bump: Version 2.0.0 introduces significant improvements and new features

Technical

• Updated GitHub workflows with improved condition syntax
• Updated Dependabot timezone to Asia/Muscat
• Added change detection to prevent unnecessary PRs in workflows
• Updated stylelint to 16.26.1

Changed

• Dependencies: Updated development and runtime dependencies
• three: ^0.181.1 → ^0.181.2 (patch update)
• stylelint: ^16.25.0 → ^16.26.0 (dev)
• vite: ^7.2.2 → ^7.2.4 (dev)

Added

• AnycubicSlicer Support: Added integration for AnycubicSlicer with custom icon and URL scheme. (#52)
• Folder Exclusion: Added support for .no3d marker file to exclude specific folders from 3D file scanning.
• Hidden Folder Exclusion: Automatically exclude hidden folders (starting with .) from the file index.
• Temp File Cleanup: Implemented background job to automatically clean up .3dviewer_temp files older than 24 hours.

Fixed

• Layout Issue: Fixed white empty space when hiding the navigation sidebar by ensuring correct flexbox behavior and explicit slot usage.
• Viewer Resizing: Fixed 3D canvas visual resizing issue by syncing internal resolution with CSS dimensions (width: 100%).
• Slicer Icons: Fixed missing slicer icons by using the correct imagePath helper for asset URLs.
• "By Folder" Navigation: improved folder indexing logic to correctly build hierarchy and handle edge cases.
• Server Error: Resolved persistent preg_match error in PreviewManager by disabling unused app preview provider registration.

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"
• Migration Class Declaration: Fixed missing class declaration in migration file
• Added class Version010902Date20251116061241 extends SimpleMigrationStep declaration
• Resolves syntax error: "unexpected token \"public\", expecting end of file"
• Folder Path Length: Removed the 512-character limit by hashing folder paths for indexing
• Restored folder_path to TEXT and added a folder_path_hash column with a new migration
• Existing rows are backfilled automatically so deep folder structures continue to work

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"
• Migration Class Declaration: Fixed missing class declaration in migration file
• Added class Version010902Date20251116061241 extends SimpleMigrationStep declaration
• Resolves syntax error: "unexpected token \"public\", expecting end of file"

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"
• Migration Class Declaration: Fixed missing class declaration in migration file
• Added class Version010902Date20251116061241 extends SimpleMigrationStep declaration
• Resolves syntax error: "unexpected token \"public\", expecting end of file"

Fixed

• Preview Provider Registration: Fixed ArgumentCountError during app service registration
• registerPreviewProvider() requires 2 arguments (MIME type and provider class)
• Now registers ModelPreviewProvider for each supported MIME type individually
• Resolves error: "Too few arguments to function registerPreviewProvider(), 1 passed and exactly 2 expected"

Added

• Database-Backed File Indexing: New tv_file_index database table for fast folder, type, date, and favorites navigation
• Automatic indexing via filesystem event listeners (NodeCreated, NodeWritten, NodeDeleted)
• Manual reindexing via php occ threedviewer:index-files [userId] command or /apps/threedviewer/api/files/index endpoint
• Migration automatically creates the index table on upgrade
• Smart File Browser: Complete file navigation system with multiple view modes
• Viewer mode: Opens 3D viewer by default on app load
• Folders mode: Hierarchical folder navigation with recursive folder structure
• Type mode: Browse files grouped by extension (GLB, GLTF, OBJ, etc.)
• Date mode: Browse files organized by year and month
• Favorites mode: View all favorited 3D files using Nextcloud system tags
• Breadcrumb navigation for easy navigation back through folder/type/date hierarchies
• Consistent card-based UI for folders, types, dates, and files
• Per-User Configuration: Remembers user preferences via ConfigController
• Saves preferred sort mode (viewer/folders/type/date/favorites)
• Remembers last opened file ID for session persistence
• Mobile experience: automatically hides the circular 3D controller when the viewer detects a small/mobile viewport, preventing overlap with the canvas controls.

Changed

• Viewer opens by default on app load; the file browser now appears only when a user explicitly selects a navigation mode.
• GET /apps/threedviewer/api/files/list now serves hierarchical payloads from the database index (folders, types, dates, favorites) instead of scanning filesystem
• Supports includeDependencies=1 parameter to return all files including textures and nested subfolders for multi-file model loading
• Dramatically reduces filesystem scans and improves performance
• Navigation data is loaded lazily per sort mode and cached so switching between viewer and browser modes no longer blocks on loading every file upfront.
• File browser UI refinements:
• File cards now share the same compact layout as folder cards (consistent padding, thumbnail sizing, fonts, and grid spacing).
• Type view heading and breadcrumbs no longer show a leading dot (e.g. GLB instead of .GLB).
• Breadcrumb component now handles clicks directly via NcBreadcrumb to improve reliability.
• Remembered folder/type state is cleared when returning to the root via breadcrumbs to ensure a fresh reload.

Fixed

• Newly uploaded, edited, or deleted 3D files (and favorites) appear instantly in every navigation mode because the indexing listener reacts to filesystem events instead of relying on manual rescans.
• Root breadcrumb ("Home") navigation restores the folder list correctly, even after drilling into nested folders.
• Multi-file dependency loading:
• Backend listFiles now supports includeDependencies=1 to return every file (including textures) and nested subfolders.
• The dependency crawler recursively searches texture subdirectories so 3DS/FBX models with textured assets load successfully.
• Texture search now uses the updated backend response structure to avoid missing files and 404 fetches.

Technical

• Created lib/Db/FileIndex.php and lib/Db/FileIndexMapper.php for database operations
• Created lib/Service/FileIndexService.php for indexing logic
• Created lib/Listener/FileIndexListener.php for automatic index updates
• Created lib/Command/IndexFiles.php for manual reindexing command
• Created lib/Controller/ConfigController.php for user preference storage
• Created lib/Migration/Version010902Date20251116061241.php for database schema migration
• Created src/components/FileNavigation.vue and src/components/FileBrowser.vue for new navigation UI
• Updated lib/Controller/FileController.php with new listFiles() and indexFiles() endpoints

Added

• Preview Provider Implementation: Implemented Nextcloud IPreviewProvider interface for 3D model previews
• Admins can enable/disable via enabledPreviewProviders config in config/config.php
• Integrates with Nextcloud's native preview system
• When enabled, provider is registered and ready for future preview rendering implementation
• When disabled, Nextcloud automatically uses custom filetype SVG icons

Changed

• Updated dependencies:
• three: ^0.181.0 → ^0.181.1 (patch update)
• @nextcloud/router: ^3.0.1 → ^3.1.0 (minor update)
• vite: ^7.1.12 → ^7.2.2 (patch update)
• @nextcloud/browserslist-config: ^3.1.1 → ^3.1.2 (patch update)
• Improved duplicate registration prevention:
• Added guards to prevent duplicate file action registration
• Added guards to prevent duplicate viewer handler registration
• Enhanced error handling with try-catch blocks

Removed

• ThumbnailController: Removed custom thumbnail controller endpoint
• Replaced by proper Nextcloud IPreviewProvider implementation
• No longer needed as Nextcloud handles previews natively
• Thumbnail Placeholder: Removed dependency on thumbnail-placeholder.png
• Nextcloud automatically uses custom filetype icons when previews are disabled
• Custom icons already registered via mimetypemapping.json
• CSS Thumbnail Overrides: Removed CSS rules that forced app.svg background on thumbnails
• Allows Nextcloud's preview system to work properly
• Custom filetype icons display correctly when previews are unavailable

Fixed

• Duplicate Registration Warnings: Fixed console warnings about duplicate settings/registrations
• Added registration guards using window/globalThis flags
• Improved handler registration checks
• Better error handling for duplicate registrations

Technical

• Created lib/Preview/ModelPreviewProvider.php implementing IPreviewProvider
• Registered preview provider in Application.php bootstrap
• Removed THUMBNAIL endpoint from constants and API documentation
• Updated openapi.json with preview provider documentation

Added

• 🖨️ Slicer Integration: Send 3D models directly to slicer applications for 3D printing
• Support for PrusaSlicer, UltiMaker Cura, BambuStudio, OrcaSlicer, Simplify3D, and Eufy Studio
• One-click export with URL scheme integration
• Automatic STL conversion and temporary share link creation
• Professional slicer logos with brand-matched colors
• Last used slicer appears first for quick access
• Smart detection of uninstalled slicers with user-friendly error messages
• Auto-download fallback when slicer app is not registered
• Temporary file cleanup after 2 minutes
• Share links expire after 24 hours for security
• SlicerController API: Backend controller for handling slicer exports
• POST /api/slicer/temp - Upload STL and create temporary share link
• GET /api/slicer/temp/{fileId} - Download temporary file
• DELETE /api/slicer/temp/{fileId} - Delete temporary file and share
• Automatic cleanup of old temporary files
• Proper filename sanitization for paths and special characters
• CORS headers for slicer application compatibility

Changed

• Updated app version to 1.9.0
• Enhanced toolbar with "Send to Slicer" button
• Added slicer integration to slide-out tools panel
• Improved error handling with toast notifications
• Updated translations for all supported languages

Technical

• Created appinfo/routes.php for route registration
• Added @NoCSRFRequired annotations for API endpoints
• Implemented Nextcloud native share system for temporary URLs
• Fixed filename handling for files with paths and special characters
• Added proper authentication and cleanup mechanisms

Added

• Screenshot Feature: Capture high-quality screenshots of 3D models directly from the viewer
• PNG and JPEG format support with configurable quality
• Automatic filename generation with timestamp
• Accessible from toolbar and tools panel
• Download screenshots directly to local device
• Fixed WebGL renderer configuration to enable screenshot capture (preserveDrawingBuffer: true)
• Billboard Text Labels: Annotation and measurement text now always faces the camera
• Text remains readable from any viewing angle
• No more reversed/mirrored text when viewing from behind
• Smooth rotation as camera moves around the model
• Improved user experience for annotations and measurements

Changed

• Updated app version to 1.8.0
• Enhanced info.xml with new feature descriptions
• Updated English translations for screenshot and billboard features

Fixed

• CSP Conflicts: Removed global CSP listener that was breaking other Nextcloud apps (Memories, etc.)
• File Icons: Fixed custom file type icons not displaying by copying them to correct location
• App Compatibility: CSP modifications now only apply to 3D viewer routes, allowing other apps to function normally

Changed

• CSP headers now scoped to specific 3D viewer routes instead of globally
• Added automatic icon copying during build process (scripts/copy-icons.mjs)
• Removed lib/Listener/CspListener.php (no longer needed)

Fixed

• Viewer Integration: Fixed files() method not storing files list, causing "No files provided, skipping update" error
• File Loading: Fixed TypeError: Cannot read properties of undefined (reading 'filename') when opening 3D files
• Static Assets: Fixed 500 error when loading app-color.svg due to route conflicts
• Route Structure: Changed viewer route from /{fileId} to /f/{fileId} to prevent conflicts with static assets
• Axes Positioning: Axes helper now positioned at bottom center of models, aligned with grid
• Axes Scaling: Made axes size dynamic (25% of model's largest dimension, minimum 5 units)
• Logo Loading: Fixed app logo path in demo scene to use generateUrl() for correct URL resolution

Changed

• Enhanced files() method in ViewerComponent with fallback logic to create synthetic file from props
• Simplified PageController by removing unnecessary is_numeric() checks
• Updated URL structure for better RESTful design: /apps/threedviewer/f/{fileId}
• Axes now recreate on model load to ensure proper sizing and positioning

Fixed

• Viewer Integration: Fixed files() method not storing files list, causing "No files provided, skipping update" error
• File Loading: Fixed TypeError: Cannot read properties of undefined (reading 'filename') when opening 3D files
• Static Assets: Fixed 500 error when loading app-color.svg due to route conflicts
• Route Structure: Changed viewer route from /{fileId} to /f/{fileId} to prevent conflicts with static assets

Changed

• Enhanced files() method in ViewerComponent with fallback logic to create synthetic file from props
• Simplified PageController by removing unnecessary is_numeric() checks
• Updated URL structure for better RESTful design: /apps/threedviewer/f/{fileId}

Fixed

• Dark Theme Support: Fixed slide-out toolbar panel not responding to theme changes
• Theme Switching: Implemented reactive theme binding using Vue computed properties
• CSS Integration: Converted base styles to use Nextcloud CSS variables for better theme integration
• UI Consistency: Toolbar panel now properly switches between Light, Dark, and Auto themes

Changed

• Improved maintainability by using Nextcloud's standard color system throughout the toolbar
• Enhanced theme responsiveness with component-level class binding

Added

• 3D Camera Controller: New circular controller interface for intuitive 3D model navigation
• Camera Control Methods: Advanced camera manipulation including rotation, zoom, and directional nudging
• View Snapping: Animated camera transitions to predefined views (Front, Back, Left, Right, Top, Bottom)
• Controller Persistence: Save and restore controller position and visibility preferences
• Smooth Animations: Eased camera transitions with customizable duration and easing functions
• Face Labels: Orientation markers (TOP, BOTTOM, FRONT, BACK, LEFT, RIGHT) on model faces
• Export Functionality: Export models to GLB, STL, and OBJ formats
• Camera Projection Toggle: Switch between perspective and orthographic views
• Progressive Texture Loading: Background texture loading for improved performance
• Dependency Caching: IndexedDB caching system for faster multi-file model loading
• Model Statistics Panel: Detailed information about loaded models
• Help Panel: Comprehensive in-app documentation and controls guide
• Theme Customization: Enhanced theme switching with RTL support
• Performance Overlay: Visual performance stats display with real-time monitoring
• KTX2 Texture Support: GPU texture compression for better performance