BlackHole

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

Don't forget to ⭐ the repo

Download

Translations

Translate App on Weblate

Features

Best 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 © 2021 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/Sangwan5688/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 :)

Want to test Beta Versions? Need help??

You can join our Telegram Channel or Telegram Group, if you have any query, or need help with something as well as to get beta updates of the project.

Liked my work?

What's New

To read full changelog visit the wiki page

hassan-zafar/BlackHole