A beautiful cross-platform Quran audio player built with Flutter. Supports Windows, Linux, and Android with a modern Windows 11-style interface.
- Multiple Reciters: Choose from popular Quran reciters with Arabic and English names
- Beautiful UI: Modern Windows 11-style design with custom title bar and window controls
- Dark/Light Theme: Smooth theme switching with fade animations
- Responsive Design: Adapts to different screen sizes (mobile and desktop)
- Mini Player: Compact player controls while browsing surahs
- Auto Playback: Automatically plays next surah when current finishes
- Flutter SDK 3.41.6 or higher
- Windows 10+ / Linux / Android
- Clone the repository
git clone https://github.com/user/quran_player.git
cd quran_player- Install dependencies
flutter pub get- Run the app
flutter runflutter build apk --releaseflutter build windows --releaseflutter build linux --releaselib/
├── main.dart # App entry point, theme handling
├── home_screen.dart # Main UI with surah list and player
├── audio_handler.dart # Audio service integration
├── models.dart # Data models (Reciter, Surah)
├── surah_tile.dart # Surah card widget
└── widgets/
├── custom_title_bar.dart # Windows 11-style title bar
├── theme_fade_wrapper.dart # Theme transition animation
└── windows_11_button.dart # Custom window control buttons
assets/
├── quran_api.json # Reciters data
├── surah_data.json # Surahs data
├── images/ # Screenshots
└── fonts/ # Lora & Uthmanic fonts
| Package | Version | Purpose |
|---|---|---|
| audioplayers | 5.2.1 | Audio playback |
| iconsax | 0.0.8 | Modern icons |
| bitsdojo_window | 0.1.6 | Desktop window controls |
| http | 1.1.0 | Network requests |
This project is licensed under the MIT License - see the LICENSE file for details.
- Initial release
- Multiple reciters support
- Dark/Light theme
- Responsive design
- Windows 11-style interface
- Mini player
Made with <3 by Max