{"id":13685130,"url":"https://github.com/31Carlton7/sap","last_synced_at":"2025-05-01T01:31:07.575Z","repository":{"id":122947527,"uuid":"417998864","full_name":"31Carlton7/sap","owner":"31Carlton7","description":"A mobile music streaming app with a complex UI built with Flutter and the Deezer API🚀","archived":false,"fork":false,"pushed_at":"2021-11-12T16:21:40.000Z","size":59331,"stargazers_count":67,"open_issues_count":1,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-12T06:34:25.945Z","etag":null,"topics":["android","dart","flutter","ios","music"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/31Carlton7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-10-17T02:26:09.000Z","updated_at":"2024-06-30T21:23:01.000Z","dependencies_parsed_at":"2024-01-14T16:20:03.200Z","dependency_job_id":null,"html_url":"https://github.com/31Carlton7/sap","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31Carlton7%2Fsap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31Carlton7%2Fsap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31Carlton7%2Fsap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/31Carlton7%2Fsap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/31Carlton7","download_url":"https://codeload.github.com/31Carlton7/sap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251808417,"owners_count":21647287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","dart","flutter","ios","music"],"created_at":"2024-08-02T14:00:44.372Z","updated_at":"2025-05-01T01:31:07.568Z","avatar_url":"https://github.com/31Carlton7.png","language":"Dart","funding_links":[],"categories":["Dart"],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/31Carlton7/sap/blob/master/assets/images/banner.png\"\u003e \u003c/img\u003e\n\n# Sap\n\n\u003cimg src=\"https://img.shields.io/github/stars/31Carlton7/sap\"\u003e \u003c/img\u003e \u003cimg src=\"https://visitor-badge.glitch.me/badge?page_id=31Carlton7.sap\"\u003e \u003c/img\u003e\n\nSap is a music streaming \u0026 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 🌟.\n\n[License](https://github.com/31Carlton7/sap/blob/master/LICENSE)\n\n[Screenshots](#screenshots)\n\n[Video](https://github.com/31Carlton7/sap/blob/master/videos/video.mp4)\n\n[IPA \u0026 APK Downloads](https://github.com/31Carlton7/sap/blob/master/release)\n\n## Developer Info\n\nThe API for getting the music and other information are courtesy of [Deezer](https://developers.deezer.com/).\nTo 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.\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003eWhy are all the songs only 30 seconds long?\u003c/summary\u003e\nSap plays the preview of every song rather than the actual song. The Deezer API does not provide the actual song link.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eCan I load my own music?\u003c/summary\u003e\nNo.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e Why did you name it Sap?\u003c/summary\u003e\nSpecial thanks to my sister, she gave me the idea to name the app \"Sap\".\n\u003c/details\u003e\n\n## Features\n\n- _Mini Player_: A persistent mini player to play music. Has a full-screen version with slider and seek controls.\n- _Save Music_: Save all music locally to the device. (REQUIRES INTERNET CONNECTION TO PLAY).\n- _Search_: Search for Albums, Artists \u0026 Songs from Deezer's catalog.\n- _Artist Stats_: Get artist stats and most popular songs.\n- _Top Albums_: See what's new with the top albums feature in the browse screen.\n- _Top Playlists_: See what music is trending with the top playlists feature in the browse screen.\n- _Top Songs_: Get the top 10 songs currently.\n- _Liked Songs_: Like songs and add them to your Liked Songs, and find them in the Liked Songs Screen.\n\n## Getting Started\n\nAssuming 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:\n\n```\nflutter run\n```\n\nIf 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 \u0026 APK files from [here](https://github.com/31Carlton7/sap/blob/master/release) and inject it into your phone yourself.\n\n## Screenshots\n\n\n\u003ctable\u003e \n  \u003cth\u003eLight Mode\u003c/th\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e \n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_1.png\"\u003e \u003c/img\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_2.png\"\u003e \n  \u003c/img\u003e \n    \u003c/td\u003e\n    \u003ctd\u003e \n        \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_3.png\"\u003e \n  \u003c/img\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\n     \u003ctd\u003e\n       \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_4.png\"\u003e \n  \u003c/img\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_5.png\"\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e \n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_6.png\"\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n   \u003ctr\u003e\n    \u003ctd\u003e \n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_7.png\"\u003e \u003c/img\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_8.png\"\u003e \n  \u003c/img\u003e \n    \u003c/td\u003e\n    \u003ctd\u003e \n        \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/light_mode/screenshot_9.png\"\u003e \n  \u003c/img\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n\u003c/table\u003e\n\n\u003ctable\u003e \n  \u003cth\u003eDark Mode\u003c/th\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e \n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_1.png\"\u003e \u003c/img\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_2.png\"\u003e \n  \u003c/img\u003e \n    \u003c/td\u003e\n    \u003ctd\u003e \n        \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_3.png\"\u003e \n  \u003c/img\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\n     \u003ctd\u003e\n       \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_4.png\"\u003e \n  \u003c/img\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_5.png\"\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e \n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_6.png\"\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n   \u003ctr\u003e\n    \u003ctd\u003e \n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_7.png\"\u003e \u003c/img\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_8.png\"\u003e \n  \u003c/img\u003e \n    \u003c/td\u003e\n    \u003ctd\u003e \n        \u003cimg width=\"250\" src=\"https://github.com/31Carlton7/sap/blob/master/screenshots/dark_mode/screenshot_9.png\"\u003e \n  \u003c/img\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n\u003c/table\u003e\n\n## Socials\n\nIf you have any questions, you can reach me here:\n\n- Instagram: [@31carlton7](https://www.instagram.com/31carlton7/)\n- Email: carltonaikins7@gmail.com\n\nIn God we trust🙏🏾\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F31Carlton7%2Fsap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F31Carlton7%2Fsap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F31Carlton7%2Fsap/lists"}