yt_flutter_musicapi 3.1.1
yt_flutter_musicapi: ^3.1.1 copied to clipboard
A Flutter plugin for YouTube Music API that provides music search and related songs functionality using Python backend.
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.
3.1.1 #
Fixed #
-
Added proper python generator results inspector for all stream operations (search, related songs, artist songs, song details)
-
Coroutine Management: Fixed the race conditions where the plugin mixes up two song details
-
Error Handling: Improved error reporting in python and kotlin side
3.1.0 #
Fixed #
-
Stream Cancellation: Implemented proper cancellation handling for all stream operations (search, related songs, artist songs, song details)
-
Coroutine Management: Added isActive checks before processing each stream item
-
Resource Cleanup: Enhanced onCancel methods to properly clean up resources
-
Error Handling: Improved error reporting for cancelled operations
-
Clean up event sinks properly
3.0.0 #
Added #
-
Support of fetching Artist Songs
requires artistName="Obviously" -
New methods for exploring now supports 2 modes:
mode=Batch (old)&mode=Stream (new)defualts tomode=auto!required to explore the package -
Enhanced error recovery for interrupted streams
-
Stream cancellation support with proper resource cleanup
Updated #
-
Python-Kotlin bridge for efficient generator-based streaming
-
Artist songs streaming architecture to use EventChannel instead of batch processing
-
Example app with streaming visualization
Fixed #
-
Memory management during long streaming sessions
-
Thumbnail quality consistency across screens
-
Race conditions in concurrent stream operations
-
Resource leaks in generator-based implementations
Performance #
-
Reduced initial latency from 1200ms to 300ms
-
Consistent 50ms intervals between streamed items
-
Lower memory footprint during streaming (45% reduction)
-
Improved backpressure handling for slow clients
Breaking Changes #
-
(New)streamArtistSongsnow requires explicit cancellation handling -
Generator-based APIs may throw StopIteration exceptions
-
Stream order is no longer guaranteed to match original API
Migration Notes #
-
Clients should implement proper stream cancellation
-
Batch processing now requires explicit collection of stream items of this package!
-
Error handling should account for mid-stream failures
2.1.4 #
Added #
-Introduced streamSearchResults functionality for real-time streaming of search results.
This allows incremental delivery of song metadata instead of waiting for the entire batch, significantly improving responsiveness.
1.1.3 #
Fixed #
- Corrected thumbnail quality mappings in the Python layer.
LOW: w60-h60 (60x60 pixels)MED: w120-h120 (120x120 pixels)HIGH: w320-h320 (320x320 pixels)VERY_HIGH: w544-h544 (544x544 pixels)
1.1.2 #
1.0.1 #
1.0.0 #
Added #
- Initial stable release.
- YouTube Music search functionality using python's
ytmusicapiand audio usingyt-dlp. - Related songs feature based on current track.
- Support for configurable audio and thumbnail quality.
- Cross-platform structure with Android support.
- Integrated Kotlin-Python bridge using Chaquopy for backend communication.