{"id":13773718,"url":"https://github.com/ZahraHeydari/MusicPlayer","last_synced_at":"2025-05-11T06:30:39.819Z","repository":{"id":39999309,"uuid":"224468018","full_name":"ZahraHeydari/MusicPlayer","owner":"ZahraHeydari","description":"Implemented using Clean Arch, MVVM, LiveData, Room, Koin, Coil, Service, Notification and ExoPlayer","archived":false,"fork":false,"pushed_at":"2022-05-19T19:21:57.000Z","size":11022,"stargazers_count":618,"open_issues_count":4,"forks_count":88,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-11-13T07:05:32.760Z","etag":null,"topics":["android-application","clean-architecture","coil-kotlin","exoplayer","koin","livedata","livedata-viewmodel","mockito","mockito-kotlin","musicplayer","mvvm-android","mvvm-architecture","mvvm-pattern","notifications","player","player-service","playlist","room-database","unit-testing","unittesting"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZahraHeydari.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-27T16:04:50.000Z","updated_at":"2024-11-07T08:04:32.000Z","dependencies_parsed_at":"2022-06-26T07:08:19.185Z","dependency_job_id":null,"html_url":"https://github.com/ZahraHeydari/MusicPlayer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZahraHeydari%2FMusicPlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZahraHeydari%2FMusicPlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZahraHeydari%2FMusicPlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZahraHeydari%2FMusicPlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZahraHeydari","download_url":"https://codeload.github.com/ZahraHeydari/MusicPlayer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225017829,"owners_count":17407835,"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-application","clean-architecture","coil-kotlin","exoplayer","koin","livedata","livedata-viewmodel","mockito","mockito-kotlin","musicplayer","mvvm-android","mvvm-architecture","mvvm-pattern","notifications","player","player-service","playlist","room-database","unit-testing","unittesting"],"created_at":"2024-08-03T17:01:19.384Z","updated_at":"2024-11-17T08:31:28.977Z","avatar_url":"https://github.com/ZahraHeydari.png","language":"Kotlin","funding_links":[],"categories":[":art: Pattern"],"sub_categories":["MVVM"],"readme":"# Android-Clean-Arch-Room-Koin(MusicPlayer)\n\nA Simple Audio Player Android Application which has been implemented using Clean Architecture alongside MVVM design\nto play (online/offline) songs by running a service in the background and displaying a notification at top of the screen.\n\n\n\n### The flow of player module which implemented:\n\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/ZahraHeydari/MusicPlayer/blob/master/flow.png\" width=\"600\"/\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n\n\n### The App Scenario:\n\nAfter selecting songs from your device, they will be saved in database and will be displayed in a playlist. Besides when a list item\nis clicked, the song player page is displayed whereas player service is run in the background\nand notification will be displayed at top of the screen.(Clicking on notification has been handled!)\nAlso if you click long on the song item of playlist, it will be removed both from your stored and displayed playlist.\n\n\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/ZahraHeydari/MusicPlayer/blob/master/player_list_page.jpg\" width=\"250\"/\u003e\n  \u003cimg src=\"https://github.com/ZahraHeydari/MusicPlayer/blob/master/song_player_page.jpg\" width=\"250\"/\u003e\n  \u003cimg src=\"https://github.com/ZahraHeydari/MusicPlayer/blob/master/player_notification.jpg\" width=\"250\"/\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n\n\n### Technologies \u0026 Methodologies which used:\n\n- Koin\n- Clean Architecture\n- MVVM Pattern\n- LiveData\n- Coil(Image Loader)\n- ExoPlayer\n- Mockito\n\n\n\n### The features of player module:\n\n- The player service run in the background and can`t be killed until user stops a song.\n- The notification of playing song will be diplayed at top of screen. (both collapse/Expand views were supported)\n- Player actions in use consists of play/pause, skip to next/previous, repeat one song, repeat all songs,\nshuffle songs,...\n- Supported swiping to left/right side.\n\n\n\n### Supported Android Versions:\n\n- Android 4.0.3 Ice Cream Sandwich(API level 16) or higher\n\n\n\n### Used libraries:\n\n1. [Github](https://github.com/casidiablo/multidex) - Multidex\n2. [Github](https://github.com/InsertKoinIO/koin) - Koin\n3. [Github](https://github.com/coil-kt/coil) - Coil\n4. [Github](https://github.com/google/ExoPlayer) - ExoPlayer\n5. [Github](https://github.com/mockito/mockito) - Mockito\n\n\n\n## License\n\n```\nCopyright (c) 2019 ZARA (https://github.com/ZahraHeydari/).\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZahraHeydari%2FMusicPlayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZahraHeydari%2FMusicPlayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZahraHeydari%2FMusicPlayer/lists"}