BlackHole

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

Don't forget to :star: the repo

Download

<img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" alt="Get it on IzzyDroid" height="100"> <img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="100">

      <img src="https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white" alt="Download from GitHub" height="60">        <img src="https://img.shields.io/badge/Telegram-2CA5E0?logo=telegram&logoColor=white" alt="Join Telegram Channel" height="60">

Translations

• Spanish :es:
• Russian :ru:
• French :fr:
• Portuguese :brazil:

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 Wali Ullah Shuvo

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/StarsWarrior/BlackHole.git

3. 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