NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3381 most downloaded on pub.dev
Flutter Plugin used to query audios/songs infos [title, artist, album, etc..] from device storage.
Last release 3 years ago
no release in 18 months
Ships unpredictably
gaps range from 9 days to 9 months
Nearly every release is documented
notes for 35 of 35 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
40 releases · first in 2021
Update pubspec
Update pubspec
Features Added support to Dart 3.
Fixed broken pubspec links. - #115
One column per quarter.
Moved android and ios into separated folders.
showDetailedLog.android and ios into separated folders./details with /src.1.4.32 to 1.6.10. - #1101.5.2-native-mt to 1.6.4.Added [PermissionController] (Native)
[LogType].[LogConfig].[PermissionController] (Native)[PluginProvider] (Native)[setLogConfig] method.[checkAndRequest] method.[controller] to [QueryArtworkWidget].[retryRequest] param to [checkAndRequest] and [permissionsRequest].200 using [queryArtwork].artwork resolution (from 100 to 50).[QueryArtworkWidget] params.[QueryArtworkWidget].quality param from [QueryArtworkWidget].
50.2.12 to 2.17.[Fixed] incompatibility with Android 13 . - #91 - Thanks @ruchit-7span
Android 13. - #91 - Thanks @ruchit-7span[Fixed] incompatibility with Flutter 3 . - #78
Updated DEPRECATED documentation.
[scanMedia] method that will scan the given path and update the [Android] MediaStore.[querySongs] even after deleting with [dart:io]. - #67README documentation.DEPRECATED documentation.PLATFORMS documentation.broken links.Fixed song/artist/album from Apple Music returning when 'querying' - #61
Changes [Updated] all Github links.
Fixed wrong value returning from: - #56
[is_music].[is_alarm].[is_notification].[is_ringtone].[is_podcast].[is_audiobook].README documentation.Fixed wrong value returning from [artistId] when using [AlbumModel]. - #54
Added errorBuilder and frameBuilder to [QueryArtworkWidget].
[2.5.0] release.errorBuilder and frameBuilder to [QueryArtworkWidget].[querySongs].See all development changes:
Updated DEPRECATED documentation.
artwork to genres. - #41sortType, orderType and ignoreCase to [queryAudiosFrom].path parameter to [querySongs]. - #48path parameter to [querySongs].Uint8List when using [queryArtwork] on Android 7. - #47albumId when using Android 9 or below. - #53README documentation. New [queryAudiosFrom] section.DEPRECATED documentation.Kotlin and Gradle version. - #51[albumId] from [AlbumModel].
[id] instead.Fixed no artwork returning from [queryArtwork] when using ArtworkType.ALBUM. - #45
[queryArtwork] when using ArtworkType.ALBUM. - #45README documentation.Fixed wrong type of numOfSongs from [SongModel]. - #39
Added a better 'search' method to [queryWithFilters], now the query uses 'contains' when 'querying'. - #35
[queryWithFilters], now the query uses 'contains' when 'querying'. - #35[MPMediaQuery] type and wrong value from [jpegData]. - #37README links. - #36README documentation.Fixed error when trying to build using Android. - #32 & #33
[ignoreCase] to:
[querySongs].[queryAlbums].[queryArtists].[queryPlaylists].[queryGenres].error when trying to build using Android. - #32 & #33error related to android song projection. - #31'bug' when using SongSortType.TITLE. This is now a 'feature' and can be controlled using [ignoreCase]. - #29README documentation.[Kotlin] and [Dependencies] versions.[JCenter] to [MavenCentral].Added [numOfSongs] to [PlaylistModel] and [GenreModel].
[numOfSongs] to [PlaylistModel] and [GenreModel].Playlist and Artist to ArtworkType.quality to queryArtwork.[isAudioBook], [Genre] and [GenreId] to [SongModel].[SongModel]:
[isAlarm].[isMusic].[isNotification].[isPodcast].[isRingtone].[id] when using [ArtistModel].[id] when using [GenreModel].[queryAudiosFrom] when using ARTIST_ID.README documentation.OnAudioQuery and OnAudioQueryExample documentation to support new [Flutter 2.5].DATA_ADDED to DATE_ADDED for both [SongSortType] and [PlaylistSortType]. - #27args from [queryWithFilters] is no longer required.[DEFAULT] from [SongSortType].[DEFAULT] from [PlaylistSortType].[DEFAULT] from [ArtistSortType].[DEFAULT] from [AlbumSortType].[DEFAULT] from [GenreSortType].[ARTIST_KEY] from [ArtistSortType].[ARTIST_NAME] from [ArtistSortType].[ALBUM_NAME] from [AlbumSortType].[GENRE_NAME] from [GenreSortType].[DATA_ADDED] from [SongSortType].[DATA_ADDED] from [PlaylistSortType].<!-- Deleted files: [audios_only_type.dart] and [songs_by_type.dart] --> <!-- Changed files: [queryArtworkWidget.dart] to [query_artwork_widget.dart] -->
Added a filter to avoid cloud audios/songs.
filter to avoid cloud audios/songs.[permissionsStatus]. - #24README documentation.Fixed duplicate media from [queryWithFilters].
Fixed error when using [removeFromPlaylist]. - #22
[removeFromPlaylist]. - #22README documentation.[OnAudioQueryExample] to support [Web] platform.The plugin now utilize [Platform interface] package.
[Web].[Platform interface] package.[querySongs].[queryAlbums].[queryArtists].[queryGenres].[queryAudiosFrom].[queryWithFilters].[queryArtwork].[queryDeviceInfo].on_audio_query documentation.README documentation.PLATFORMS documentation.Web platform.### Release - [2.0.0] release. See all development changes: - 2.0.0-beta.3 - 2.0.0-beta.2 - 2.0.0-beta.1 - 2.0.0-beta.0 - 2.0.0-alpha.1 - 2.0.0-alpha.
Now ALL methods will only "query" if has permission to Library.
"query" if has permission to Library.[addToPlaylist].[author] and [desc] arguments to [createPlaylist]. (IOS only)[queryArtwork].[id] value returning from [PlaylistModel].README documentation.Updated DEPRECATED documentation.
[queryArtwork].error when building to [Android].[duration], [dateAdded] and [bookmark] values returning from [SongModel].on_audio_query documentation.README documentation.DEPRECATED documentation.IOS platform.[artwork] from [QueryArtworkWidget].[deviceSDK] from [QueryArtworkWidget].[requestPermission] from [QueryArtworkWidget].Updated DEPRECATED documentation.
DART ANALYZER to PULL_REQUEST and PUSH.on_audio_query documentation.README documentation.DEPRECATED documentation.PLATFORMS file.Named Optional arguments.[queryArtworks] to [queryArtwork].[requestPermission] argument from ALL methods.[queryAudios].[artwork] from [SongModel].[path] from [querySongs].Added [path] parameter to [querySongs] and [queryAudio].
[path] parameter to [querySongs] and [queryAudio].[getMap] to:
[SongModel].[AlbumModel].[ArtistModel].[GenreModel].[PlaylistModel].[DeviceModel].README documentation.Fixed [Kotlin] issue when installing the plugin.
[Kotlin] issue when installing the plugin.README documentation.[Kotlin] dependencies.Fixed [cursor] problem when using [AudiosFromType.GENRE_NAME] or [AudiosFromType.GENRE_ID] on [queryAudiosFrom]. - #16 and #12
~~Fixed [cursor] problem when using [AudiosFromType.GENRE_NAME] or [AudiosFromType.GENRE_ID] on [queryAudiosFrom].~~
[cursor] problem when using [AudiosFromType.GENRE_NAME] or [AudiosFromType.GENRE_ID] on [queryAudiosFrom].README documentation.Created DEPRECATED file/history.
[uri] to [SongModel]. - Added #10java.lang.Integer cannot be cast to java.lang.Long from [queryArtworks]. - #11README documentation.DEPRECATED file/history.[deviceInfo] to [deviceSDK] on [QueryArtworkWidget].[deviceInfo] from [QueryArtworkWidget].Added [dateModified] to [SongModel].
[queryDeviceInfo].[dateModified] to [SongModel].[querySongsBy] and [SongsByType].[permission_handler]. - #3 - Thanks @mvanbeusekom[dataAdded] to [dateAdded].README documentation.[OnAudioQueryExample] to add new [queryDeviceInfo] and [QueryArtworkWidget] methods.[Kotlin] dependencies.[Kotlin] methods.[getDeviceSDK], [getDeviceRelease] and [getDeviceCode] are part of [queryDeviceInfo].[QueryArtworkWidget] support Android above and below 29/Q/10.[size], [albumId], [artistId], [dataAdded], [dataModified], [duration], [track] and [year] from [SongModel] will return [int].Added [artworkClipBehavior], [keepOldArtwork], [repeat] and [scale] to [QueryArtworkWidget].
[artworkClipBehavior], [keepOldArtwork], [repeat] and [scale] to [QueryArtworkWidget].[QueryArtworkWidget].[queryArtworks] will return null. - #6README documentation.[queryArtworks] return [Uint8List?].Added [_display_name_wo_ext] ([displayName] without extension) to [SongModel]. - Added #5
[queryFromFolder].[queryAllPath].[_display_name_wo_ext] ([displayName] without extension) to [SongModel]. - Added #5[file_extension] (Only file extension) to [SongModel].[file_parent] (All the path before file) to [SongModel].[Genre] to [queryAudiosFrom].[ALBUM_ID], [ARTIST_ID] and [PLAYLIST_ID] to [AudiosFromType]. - Added #2README documentation.[queryAudiosFrom] supports [name] and [id].[albumId] from [AlbumModel] return a [int].[Kotlin] checks will throw a [Exception] if value don't exist.[Kotlin] dependencies.[ALBUM], [ARTIST] and [PLAYLIST] to [ALBUM_NAME], [ARTIST_NAME] and [PLAYLIST_NAME] in [AudiosFromType].Fixed [queryArtwork] returning null album image in Android 11. - #1
[queryArtwork] returning null album image in Android 11. - #1README documentation.[WithFiltersType].[Kotlin] dependencies.Added [AudiosOnlyType] and [WithFiltersType].
[queryAudiosOnly].[queryWithFilters].[AudiosOnlyType] and [WithFiltersType].[SongsArgs], [AlbumsArgs], [PlaylistsArgs], [ArtistsArgs], [GenresArgs].[EXTERNAL] and [INTERNAL] parameters for some query methods.README documentation.[querySongs], [queryAlbums], [queryArtists], [queryPlaylists] and [queryGenres] have [UriType] as parameter.[Kotlin] dependencies.### ⚠ Important Changes #### Dart - Migrate to null safety.
Fixed [audiosFromPlaylist] [Now this method is part of queryAudiosFrom]
[audiosFromPlaylist] [Now this method is part of queryAudiosFrom]"count(*)" error from [addToPlaylist]. [Permission bug on Android 10 still happening]README documentation.[Id] in models return [int] instead [String].[ALBUM_KEY], [ARTIST_KEY] from all query audio methods.[audiosFromPlaylist] to [queryAudiosFrom].### Release - [on_audio_query] release.
[on_audio_query] release.Your coding agent can read these notes before it upgrades. Set up the MCP server →