wave_player 0.0.1

A Flutter package for audio waveform visualization and playback with customizable UI components.

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.

0.0.1 - 2025-09-08

🎉 Initial Release

This is the first release of Wave Player, a comprehensive Flutter package for audio waveform visualization and playback.

Added

• Initial release of Wave Player package
• WaveformPlayer widget with comprehensive audio visualization and playback controls
• BasicAudioSlider widget with customizable waveform display and multiple thumb shapes
• AudioManager singleton service for coordinated audio playback management
• RealWaveformGenerator service for generating waveform data from audio files
• Comprehensive theming system with WavePlayerTheme for easy customization
• Support for multiple thumb shapes: circle, verticalBar, roundedBar
• Extensive customization options for colors, text styles, and animations
• Cross-platform support for Android, iOS, Web, Windows, macOS, and Linux
• Professional documentation with examples and API reference
• Complete example application demonstrating all features

Features

• Real-time waveform visualization with smooth animations
• Interactive play/pause controls with visual feedback
• Precise seek functionality with drag-and-drop support
• Highly customizable UI components with extensive theming
• Global theme management for consistent app-wide styling
• Coordinated audio playback to prevent multiple audio streams
• Comprehensive error handling with user-friendly callbacks
• Responsive design that adapts to different screen sizes
• Optimized performance for smooth audio playback

Technical Details

• Built with Flutter 3.6+ and Dart 3.6+
• Uses just_audio for reliable audio playback
• Leverages path_provider for file system access
• Implements permission_handler for proper permission management
• Utilizes http for network audio file requests
• Follows Flutter best practices and Material Design guidelines

Breaking Changes

• None (this is the initial release)

Migration Guide

• This is the first release, so no migration is needed
• Future versions will maintain backward compatibility where possible

Known Issues

• None at this time

Future Plans

• Enhanced waveform visualization options
• Additional thumb shapes and customization
• Performance optimizations
• More comprehensive theming options