How abdullah7795/blackhole works
Project type and purpose
• This is a fully client‑side, cross‑platform mobile and desktop application built with Flutter. Its purpose is to serve as an open‑source music player that streams from and integrates with external services (Spotify, YouTube), manages local/offline playback, and provides a rich UI across Android, iOS, Linux, and Windows.
File structure
• Top‑level “android”, “ios”, “linux”, “windows” folders contain the platform embeddings, native code, plugin registrants, and build configurations.
• The core application logic lives under “lib/”:
• APIs: HTTP clients for Spotify and other web services.
• Services: background audio, download manager, isolate spawners, storage providers.
• Helpers: utility functions, playlist import/export, tagging, cache, logging.
• CustomWidgets & Screens: the presentation layer broken into reusable widgets and feature screens.
• Localization & theme: multi‑language support and theming configurations.
• pubspec.yaml & analysis_options.yaml define dependencies and lint rules. fastlane/metadata holds Play Store metadata.
README for additional insights
• Confirms it’s a Flutter app with streaming, offline mode, multiple external integrations, background audio, and plugin usage (audio_service, network, file storage).