Repo Banner

BlackHole

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

Release Downloads

Don't forget to :star: the repo

Download

Translations

Translate App on Weblate

Features

High Streaming Quality (320kbps AAC)
Song, Album, Artist and Playlist Search
Language Specific Promoted Playlists
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

License

Copyright © 2024 Koudjo forked from Ankit Sangwan

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

If you don't have Flutter SDK installed, please visit official Flutter site.
Fetch latest source code from master branch.

git clone https://github.com/kametepe/BlackHole.git

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 :)

Liked the work, buy me a Coffee ?

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.

kametepe / BlackHole

readme