/BlackHole

A Music Player App made with Flutter

Primary LanguageDartGNU General Public License v3.0GPL-3.0

Warning

The original app and its code have been deleted. I use this app since a lot of time, so I decided to continue the development by adding features that I find useful, updating the codebase... Releases will be signed with my own signature, so a backup is needed to switch from the original app, but the app can be installed alongside the original.
Source: original repo (Wayback Machine)

Repo Banner

BlackHole

An Open-Source Music Player App for all your needs!

made-with-flutter Release Downloads Build Translation-Status

Don't forget to ⭐ the repo

GitHub stars GitHub forks GitHub followers

Download

Android only

Download from GitHub

Translations

Features

  • High Streaming Quality (320kbps AAC)
  • Song, Album, Artist Playlist and Podcast Search
  • Language Specific Promoted Playlists
  • Podcasts streaming
  • Trending Songs
  • Artist and Genre Radios
  • Support 15+ music languages
  • Local and Global Top Spotify songs
  • Add Songs to Favorite
  • Playlists support
  • Import Playlists from Spotify & YouTube
  • Import/Export Playlists as JSON File
  • Share Playlists
  • Sleep timer
  • Lyrics Support
  • Queue Management
  • Listening history record
  • Dark mode / accent color
  • Custom Gradients and other Theme options
  • Supports Portrait as well as Landscape mode
  • Download for offline play (320kbps with ID3 tags)
  • Play Online as well as Offline Songs
  • Tag Editing Support
  • Trending Search Results
  • YouTube Search Support
  • Promoted Youtube Playlists
  • Play videos as audio
  • Auto Song Recommendations
  • Inbuilt Equalizer
  • Backup & Restore
  • Auto Update Check
  • Cache support
  • No Subscription
  • No Ads

and much more... Check it yourself :)

Screenshots

Note

The screenshots are not updated. Now the miniplayer has color, as well as the player's buttons (among other changes).

License

Copyright © 2024 BrightDV

BlackHole is a free software licensed under GPL v3.0
It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Being Open Source doesn't mean you can just make a copy of the app and upload it on playstore or sell
a closed source copy of the same.
Read the following carefully:
1. Any copy of a software under GPL must be under same license. So you can't upload the app on a closed source
  app repository like PlayStore/AppStore without distributing the source code.
2. You can't sell any copied/modified version of the app under any "non-free" license.
   You must provide the copy with the original software or with instructions on how to obtain original software,
   should clearly state all changes, should clearly disclose full source code, should include same license
   and all copyrights should be retained.

In simple words, You can ONLY use the source code of this app for `Open Source` Project under `GPL v3.0` or later
with all your source code CLEARLY DISCLOSED on any code hosting platform like GitHub, with clear INSTRUCTIONS on
how to obtain the original software, should clearly STATE ALL CHANGES made and should RETAIN all copyrights.
Use of this software under any "non-free" license is NOT permitted.

See the GNU General Public License for more details.

Building from Source

  1. If you don't have Flutter SDK installed, please visit official Flutter site.
  2. Fetch latest source code from master branch.
git clone https://github.com/BrightDV/BlackHole.git
  1. Run the app with Android Studio or VS Code. Or the command line:
flutter pub get
flutter run

Contribute

Contributions are welcome. Please read our contributing guidelines before contributing.

Facing any Issue?

Have a look at some common Issues that you might face. If your problem is not there, feel free to open an Issue :)

What's New

To read full changelog visit the wiki page

Disclaimer

BlackHole does not own or have any affiliation with the songs and other content available through the app.
All songs and other content are the property of their respective owners and are protected by copyright law.
BlackHole is not responsible for any infringement of copyright or other intellectual property rights that may result
from the use of the songs and other content available through the app. BlackHole uses third-party plugins and
is not responsible for any harm or damage to the respective owners or any other parties resulting from the use
of the songs and other content through the third-party plugins.
By using the app, you agree to use the songs and other content only for personal, non-commercial purposes
and in compliance with all applicable laws and regulations.