{"id":13679534,"url":"https://github.com/musicbeeremote/mbrc","last_synced_at":"2025-04-29T19:31:27.499Z","repository":{"id":8975126,"uuid":"10718841","full_name":"musicbeeremote/mbrc","owner":"musicbeeremote","description":"MusicBee Remote for Android","archived":false,"fork":false,"pushed_at":"2025-02-22T00:18:10.000Z","size":8059,"stargazers_count":131,"open_issues_count":80,"forks_count":24,"subscribers_count":12,"default_branch":"development","last_synced_at":"2025-02-22T00:27:25.248Z","etag":null,"topics":["android","musicbee","remote-control"],"latest_commit_sha":null,"homepage":"https://mbrc.kelsos.net/","language":"Kotlin","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/musicbeeremote.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-06-16T10:56:51.000Z","updated_at":"2025-02-12T12:27:07.000Z","dependencies_parsed_at":"2023-02-12T09:30:16.922Z","dependency_job_id":"bbc76d3a-4f51-470b-80f4-ce7dcf951989","html_url":"https://github.com/musicbeeremote/mbrc","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musicbeeremote%2Fmbrc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musicbeeremote%2Fmbrc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musicbeeremote%2Fmbrc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musicbeeremote%2Fmbrc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/musicbeeremote","download_url":"https://codeload.github.com/musicbeeremote/mbrc/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251569548,"owners_count":21610575,"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","musicbee","remote-control"],"created_at":"2024-08-02T13:01:06.587Z","updated_at":"2025-04-29T19:31:24.374Z","avatar_url":"https://github.com/musicbeeremote.png","language":"Kotlin","funding_links":[],"categories":["Kotlin"],"sub_categories":[],"readme":"\u003c!-- Shields --\u003e\n![CI](https://github.com/musicbeeremote/android-app/workflows/CI/badge.svg)\n![GitHub](https://img.shields.io/github/license/musicbeeremote/android-app.svg)\n![GitHub release](https://img.shields.io/github/release/musicbeeremote/android-app.svg)\n[![Discord](https://img.shields.io/discord/420977901215678474.svg?style=popout)](https://discordapp.com/invite/rceTb57)\n[![Join the chat at https://gitter.im/musicbee-remote/Lobby](https://badges.gitter.im/musicbee-remote/Lobby.svg)](https://gitter.im/musicbee-remote/Lobby?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n\u003cbr/\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/musicbeeremote/android-app\"\u003e\n    \u003cimg src=\"logo.png\" alt=\"Logo\" width=\"80\"   height=\"80\" /\u003e\n    \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eMusicBee Remote\u003c/h3\u003e\n    \u003cp align=\"center\"\u003e\n        Application for controlling MusicBee through your Android Device \n        \u003cbr/\u003e\n        \u003cdel\u003e\u003ca href=\"https://play.google.com/store/apps/details?id=com.kelsos.mbrc\"\u003ePlay Store\u003c/a\u003e\u003c/del\u003e(Unpublished as of January 2023)\n        \u003cbr/\u003e\n        \u003cbr/\u003e\n        \u003ca href=\"https://mbrc.kelsos.net/help/\"\u003eHelp\u003c/a\u003e\n        ·\n        \u003ca href=\"http://getmusicbee.com/forum/index.php?topic=7221.new;topicseen#new\"\u003eMusicBee Forum\u003c/a\u003e\n        ·\n        \u003ca href=\"https://github.com/musicbeeremote/android-app/issues\"\u003eReport Bug\u003c/a\u003e\n        ·\n        \u003ca href=\"https://github.com/musicbeeremote/android-app/issues\"\u003eRequest Feature\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/p\u003e\n\n## Application development status\n**As of January 2023 the application is now unpublished from Play Store and considered unmaintained.** For the majority of 2022 I didn't have the energy or time to continue with the development and support of the application. I might still answer support e-mails and you can still use the available builds but the application will be as it is.\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n* [About the Project](#about-the-project)\n  * [Built With](#built-with)\n* [Getting Started](#getting-started)\n  * [Prerequisites](#prerequisites)\n  * [Installation](#installation)\n* [Usage](#usage)\n* [Contributing](#contributing)\n* [License](#license)\n* [Contact](#contact)\n* [Acknowledgements](#acknowledgements)\n\n## About the Project\n\n[![MusicBee Remote Screenshot][project-screenshot]](https://mbrc.kelsos.net)\n\nMusicBee Remote is an application that allows you to control [MusicBee](http://getmusicbee.com/) player.\nThis is achieved by using a [plugin](https://github.com/kelsos/mbrc-plugin) that acts as a server.\nThe plugin exposes a TCP socket server and uses a JSON based protocol to communicate with the Android application.\n\nThe application development started in 2011 for personal usage and then it was open sourced and released to Play Store so others could use it. The application was also presented as part of my thesis title \"*Android and application development for mobile devices*\".\n\n### Built With\n\n* [Kotlin](https://kotlinlang.org/)\n* [Architecture Components](https://developer.android.com/topic/libraries/architecture)\n* [Koin](https://github.com/InsertKoinIO/koin)\n* [Moshi](https://github.com/square/moshi)\n* [mockk](https://mockk.io/)\n* [rxjava](https://github.com/ReactiveX/RxJava)\n* [arrow-kt](https://github.com/arrow-kt/arrow)\n* [robolectic](http://robolectric.org/)\n\n## Getting Started\n\nIn order to get started with the project as a developer there are a few steps you need to follow.\n\n### Prerequisites\n\nAndroid Studio should be installed on your local machine and it should be up to date.\n\nDuring development the Canary version of the Android Studio is used, but for release versions the stable version of AGP is always preferred.\n\nTo get started with the the project you first have to clone the project.\n\n```bash\ngit clone https://github.com/musicbeeremote/android-app.git\n```\n\nThen you can open the project with Android Studio.\n\n### Installation\n\nThere is a number of ways you could install the application on your device. If you are a developer you can run install on Android Studio and that should take care of the installation.\n\nAlternatively you could download a stable version of the Remote from [Play Store](https://play.google.com/store/apps/details?id=com.kelsos.mbrc).\n\nThe Play Store version of the remote include FireBase and Crashlytics and collects anonymous analytics.\n\nAlternatively there is a GitHub version on the [releases](https://github.com/musicbeeremote/android-app/releases) page that doesn't include any Crash or analytics reporting for people that are cautious about their privacy.\n\n## Usage\n\nIn order to use the application you need a working WiFi connection, that doesn't have [access point isolation](https://www.howtogeek.com/179089/lock-down-your-wi-fi-network-with-your-routers-wireless-isolation-option/).\n\nYou have to first install the [plugin](https://github.com/musicbeeremote/android-app/releases).\n\nAfter installing the plugin if you are not prompted to allow MusicBee or the plugin through the Windows Firewall you might have to manually configure Windows Firewall to allow the plugin to receive connections.\n\nFor more detailed information you can check the [help](https://mbrc.kelsos.net/help/) page.\n\n## Contributing\n\nContribution is always welcome.\nThe contribution guide should follow soon.\n\n## License\n\nThe source code of the application is licensed under the [GPLv3](https://www.gnu.org/licenses/gpl.html) license. See `LICENSE` for more information.\n\n    MusicBee Remote (for Android)\n    Copyright (C) 2011-2019  Konstantinos Paparas\n\n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n## Contact\n\nMusicBee Remote - [@MusicBeeRemote](https://twitter.com/musicbeeremote)\n\nProject Link: [https://github.com/musicbeeremote/mbrc-plugin](https://github.com/musicbeeremote/mbrc-plugin)\n\n## Acknowledgements\n\n* [Tasos Papazoglou Chalikias](https://github.com/sushiperv)\n\nTasos created many of the icons, and was responsible for the Holo design of the application. Most of the icons are licenced under the [Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License.](https://creativecommons.org/licenses/by-nc-nd/3.0/deed.en_US).\n\n* [Jordan Georgiades](https://www.linkedin.com/in/jordan-georgiadis)\n\nJordan is responsible for the conception and creation of the application logo.\n\n* Carlos Parga\n\nCarlos created some really nice [mockups](https://groups.google.com/forum/#!topic/musicbee-remote/wgm029yfJnU) from where I drew inspiration while working on the UI.\n\n* [Cyanogen Apollo player](https://github.com/CyanogenMod/android_packages_apps_Apollo)\n\nApollo Player was one of the original sources of inspiration for the UI of MusicBee Remote\n\n* [Google Play Music for Android](https://play.google.com/store/apps/details?id=com.google.android.music)\n\n[project-screenshot]: https://raw.githubusercontent.com/musicbeeremote/android-app/master/screenshot.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmusicbeeremote%2Fmbrc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmusicbeeremote%2Fmbrc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmusicbeeremote%2Fmbrc/lists"}