Added #

• Split flutter_yt_dlp.dart into three files for improved maintainability:
  • models.dart: Contains data classes (Format, CombinedFormat, MergeFormat, DownloadProgress, DownloadState, DownloadTask).
  • utils.dart: Contains utility functions (setupLogging, generateOutputPath, convertFormatToMap).
  • flutter_yt_dlp.dart: Main plugin class with core functionality, including formatBytes.
• Added comprehensive Dartdoc comments to public APIs to address public_member_api_docs lint warnings.
• Exposed formatBytes as a public method in FlutterYtDlpPlugin for formatting byte sizes in a human-readable format.

Changed #

• Updated toLogString methods in models.dart to use String Function(int) syntax for better type safety.
• Adjusted imports in main.dart to reflect the new modular file structure.
• Improved logging in _fetchFormats to use a ternary operator for format type checking.
• Renamed _MyAppState to MyAppState in main.dart to resolve library_private_types_in_public_api.

Fixed #

• Resolved undefined_method: formatBytes errors in main.dart by making formatBytes a public method in FlutterYtDlpPlugin.
• Fixed undefined_identifier errors in utils.dart by adding import 'models.dart'.
• Replaced print with logging in setupLogging to fix avoid_print lint warning.
• Corrected forEach usage in _fetchFormats to a for loop to address avoid_function_literals_in_foreach_calls.

Notes #

• File sizes are kept under 100 lines each, with functions averaging around 3 lines, adhering to clean code principles.
• Some public_member_api_docs warnings remain but are informational (severity 2).

Changed #

• Removed unnecessary comments for cleaner and more maintainable code.

Added #

• Cancel Download Refinement: Enhanced the DownloadTask.cancel() method with better stream cleanup and state management, ensuring robust cancellation of ongoing downloads.

Initial Release #

• Added: Support for fetching media formats using yt-dlp:
  • Raw video with sound formats (getAllRawVideoWithSoundFormats).
  • Video and audio formats for merging (getRawVideoAndAudioFormatsForMerge).
  • Non-MP4 video formats for conversion to MP4 (getNonMp4VideoWithSoundFormatsForConversion).
  • Raw audio-only formats (getAllRawAudioOnlyFormats).
  • Non-MP3 audio formats for conversion to MP3 (getNonMp3AudioOnlyFormatsForConversion).
• Added: Download functionality with progress and state tracking:
  • Download raw video+sound, merged video+audio, and audio-only formats.
  • Real-time progress updates via progressStream.
  • State updates (preparing, downloading, merging, converting, completed, canceled, failed) via stateStream.
  • Option to cancel downloads mid-progress.
• Added: Conversion support using FFmpeg:
  • Convert non-MP4 video formats to MP4.
  • Convert non-MP3 audio formats to MP3.
• Added: Example app demonstrating all features with a simple UI.
• Platform: Android-only support via Chaquopy for Python integration (minimum SDK 24).
• Dependencies: Integrated yt-dlp (2025.2.19) and FFmpeg (6.0) via Chaquopy.
• Developed: With assistance from Grok by xAI for design and implementation.

• Placeholder for initial development version (not released).