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.
-
Improved path handling in
getMedia
- Now directly retrieves original media file paths for images and videos.
- Uses
PHAssetResource
for more accurate file access on iOS.
-
Thumbnail generation optimizations
- Web version uses
OffscreenCanvas
for faster processing.
- Web version uses
-
Refactored
getMedia
structure- Introduced
includePath
instead ofpath
for clarity. - Added better error handling when media retrieval fails.
- Introduced
-
Refactored code structure
- Moved conversion logic into separate helper functions.
- Improved maintainability and readability.
- Media retrieval issues
- Fixed an issue where
getMedia
would sometimes return stale data. - Ensured video paths are correctly fetched for playback.
- Fixed an issue where
- Renamed
generatePath
toincludePath
ingetMedia
- Update your API calls accordingly.
-
Improved MIME type detection for
getMediaList()
andgetMedia()
-
Now properly returns MIME types based on UTI or file extension fallback
-
More accurate media type detection for images and videos
-
Example with media detail view
-
Media dialog in the example project (
example
) -
Media items are now displayed in an Ionic Modal/Dialog
-
Added support for Swipe-to-Close-Feature for improved UX
-
Enhanced media detail presentation
-
New Enums for better API structure:
MediaSubtype
→ Defines special media types (motion_photo
,panorama
,hdr
,screenshot
, etc.)MediaFilter
→ Allows clear filtering (all
,panorama
,hdr
,screenshot
)
- Optimized image size calculation to prevent redundant computations
- Improvements in
getMedia
andgetMediaList
- Ensured asynchronous processing with
DispatchGroup
to guarantee complete data retrieval
- Ensured asynchronous processing with
- Improved example project with better media handling for Web and native platforms.
- Refined platform-specific logic to enhance performance.
- Implemented photo selection in Web using
showDirectoryPicker
. - Web support now properly reads images and retrieves metadata.
- iOS date format now returns a correct timestamp in milliseconds.
- iOS width & height calculation now returns the correct original dimensions instead of the thumbnail size.
- General stability and performance improvements for media retrieval.
- 🚀 Introduced a new Ionic/Angular example project for easier plugin usage.
- Implemented
getMedias
function for iOS. - Added support for filtering media by type (
image
,video
,all
). - Added sorting options (
newest
,oldest
). - Added optional flags for additional media details (
includeDetails
,includeBaseColor
). - Implemented base color extraction for images.
- Implemented permission handling (
checkPermissions
,requestPermissions
).
- Fixed TypeScript issues related to
createdAt
sorting in Web implementation. - Fixed missing function references for dominant color extraction.
- Improved compatibility with older iOS versions.
- Refactored iOS implementation to handle
PHPhotoLibrary
authorization correctly. - Updated rollup configuration to properly generate ESM, CJS, and IIFE builds.
- Initial implementation of
getMediaFiles()
- Basic Capacitor plugin setup for iOS & Android
- README, LICENSE, and project structure
- First functional beta release
- Implemented
echo()
function - Basic Capacitor plugin structure