https://github.com/harshshah6/saavnmp3-android
A simple music player inspired by spotify and developed using the unofficial JioSaavn API. Has an lot of features like Search for an Artist, Song, Playlist, Albums. Not just search this app also provides you functionality to play the songs and view the artist info and much more.
https://github.com/harshshah6/saavnmp3-android
android android-application android-music-player android-music-player-java java java-17 media-player music music-player simple-music-player song song-api song-player spotify spotify-api spotify-clone
Last synced: 4 months ago
JSON representation
A simple music player inspired by spotify and developed using the unofficial JioSaavn API. Has an lot of features like Search for an Artist, Song, Playlist, Albums. Not just search this app also provides you functionality to play the songs and view the artist info and much more.
- Host: GitHub
- URL: https://github.com/harshshah6/saavnmp3-android
- Owner: Harshshah6
- License: mit
- Created: 2024-11-23T14:33:59.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-05-17T08:17:53.000Z (5 months ago)
- Last Synced: 2025-05-17T09:25:29.808Z (5 months ago)
- Topics: android, android-application, android-music-player, android-music-player-java, java, java-17, media-player, music, music-player, simple-music-player, song, song-api, song-player, spotify, spotify-api, spotify-clone
- Language: Java
- Homepage:
- Size: 204 MB
- Stars: 13
- Watchers: 1
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SaavnMp3 / Melotune
A simple music player inspired by Spotify and developed using the unofficial JioSaavn API. It has many features like searching for Artists, Songs, Playlists, Albums, and more. The app also provides functionality to play songs, view artist info, and much more.
[](https://github.com/Harshshah6/SaavnMp3-Android/raw/refs/heads/master/app/release/app-release.apk)
[](https://www.paypal.me/HarshShah06)
## Features
* No Ads
* Play tracks in background
* Latest tracks available
* Search for Artists
* Search for Tracks
* Search for Albums
* Search for Playlists
* Doesn't collect any user data
* UI inspired by Spotify
* Auto-updating version display
* Auto-next play functionality
* HTTP/HTTPS support for music CDN domains
* Robust error handling
* Much more...
## Screenshots
## Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
### Prerequisites
* Android Studio (latest version recommended)
* Java 17+
* An Android device or emulator
### Installation
1. Clone the repository:
```bash
git clone https://github.com/harshshah6/SaavnMp3-Android.git
```
2. Open the project in Android Studio
3. Build and run the app on your device or emulator
## Recent Updates
* **Auto-updating version display**: The app now automatically displays the current version in the main drawer layout
* **Improved player controls**: Better handling of next/previous track functionality
* **Enhanced error handling**: Robust error recovery mechanisms for network operations
* **HTTP/HTTPS support**: Proper handling for music CDN domains
## Built with
* [Java 17](https://openjdk.org/projects/jdk/17/) - The programming language used
* [Saavn.dev](https://github.com/sumitkolhe/jiosaavn-api) - The unofficial JioSaavn API
* [Glide](https://github.com/bumptech/glide) - Image library used to load images from URL
* [Picasso](https://github.com/square/picasso) - Image library used to load images from URL
* [Gson](https://github.com/google/gson) - Gson library to parse JSON responses from API
* [OkHttp](https://github.com/square/okhttp) - Library to send requests to APIs and receive data
* [SwiperefreshLayout](https://developer.android.com/jetpack/androidx/releases/swiperefreshlayout) - Library for pull-to-refresh functionality
* [Shimmer](https://github.com/facebookarchive/shimmer-android) - Library for animated loading effects
* [OverscrollDecor](https://github.com/EverythingMe/overscroll-decor) - iOS style (bouncy) overscroll effect
* [SSP](https://github.com/intuit/ssp) & [SDP](https://github.com/intuit/sdp) - Dimension libraries for responsive UI
## Contributing
If you'd like to contribute to SaavnMp3-Android, here are some guidelines:
1. Fork the repository
2. Create a new branch for your changes
3. Make your changes
4. Run the project to ensure it works
5. Commit your changes
6. Push your changes to your forked repository
7. Submit a pull request
## License
This project is licensed under the [MIT License](LICENSE).
MIT License
Copyright (c) 2024 Harsh S Shah
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
## Acknowledgements
* Inspired by Spotify
* Thanks to Saavn.dev for the amazing unofficial JioSaavn API
## Contributors ✨
Thanks go to these wonderful people:
Contributions of any kind are welcome!