https://github.com/31Carlton7/sap

A mobile music streaming app with a complex UI built with Flutter and the Deezer API🚀
https://github.com/31Carlton7/sap

android dart flutter ios music

Last synced: about 1 year ago
JSON representation

A mobile music streaming app with a complex UI built with Flutter and the Deezer API🚀

Host: GitHub
URL: https://github.com/31Carlton7/sap
Owner: 31Carlton7
License: gpl-3.0
Created: 2021-10-17T02:26:09.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2021-11-12T16:21:40.000Z (over 4 years ago)
Last Synced: 2024-11-12T06:34:25.945Z (over 1 year ago)
Topics: android, dart, flutter, ios, music
Language: Dart
Homepage:
Size: 56.6 MB
Stars: 67
Watchers: 2
Forks: 10
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

# Sap

Sap is a music streaming & discovery app built with the [Deezer API](https://developers.deezer.com/) for iOS and Android. It includes a mini player, search and local storage. Be sure to leave a star 🌟.

[License](https://github.com/31Carlton7/sap/blob/master/LICENSE)

[Screenshots](#screenshots)

[Video](https://github.com/31Carlton7/sap/blob/master/videos/video.mp4)

[IPA & APK Downloads](https://github.com/31Carlton7/sap/blob/master/release)

## Developer Info

The API for getting the music and other information are courtesy of [Deezer](https://developers.deezer.com/).
To build the app I utilized the [Flutter SDK](https://flutter.dev) as the UI Framework and that uses [Dartlang](https://dart.dev) as the programming language. The list of packages the app uses can be found [here](https://github.com/31Carlton7/sap/blob/master/pubspec.yaml) under the `dependencies` indent. My UI Package I use to curate the UI can be found [here](https://github.com/31Carlton7/canton_design_system), however I will not be publishing the package on [pub.dev](pub.dev) anytime soon. This project is null safe. I also used Firebase Analytics and Crashlytics to better understand the users who use the app. There is no form of authentication or database usage.

## FAQ

Why are all the songs only 30 seconds long?
Sap plays the preview of every song rather than the actual song. The Deezer API does not provide the actual song link.

Can I load my own music?
No.

Why did you name it Sap?
Special thanks to my sister, she gave me the idea to name the app "Sap".

## Features

- _Mini Player_: A persistent mini player to play music. Has a full-screen version with slider and seek controls.
- _Save Music_: Save all music locally to the device. (REQUIRES INTERNET CONNECTION TO PLAY).
- _Search_: Search for Albums, Artists & Songs from Deezer's catalog.
- _Artist Stats_: Get artist stats and most popular songs.
- _Top Albums_: See what's new with the top albums feature in the browse screen.
- _Top Playlists_: See what music is trending with the top playlists feature in the browse screen.
- _Top Songs_: Get the top 10 songs currently.
- _Liked Songs_: Like songs and add them to your Liked Songs, and find them in the Liked Songs Screen.

## Getting Started

Assuming Flutter is installed and setup on your device (If not, follow the steps to do so [here](https://flutter.dev/docs/get-started/install)), Fork, clone, or download the code for this repository and navigate to the enclosing folder inside your terminal. Then use this command to run:

```
flutter run
```

If you would like a TestFlight version for the iOS app, please consult with me via this email: carltonaikins7@gmail.com, and I will add you to the test group. Google Play testing will be coming soon. You can also download the IPA & APK files from [here](https://github.com/31Carlton7/sap/blob/master/release) and inject it into your phone yourself.

## Screenshots

Light Mode