Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

project blue

project blue

project blue is an alternative, open source streaming music client for JRiver Media Center.

It's features include:

  • Reliable streaming from your home server running JRiver Media Center
  • Caching of audio files during playback
  • Synchronize audio from a JRMC server to device
  • Play local files when present and metadata match
  • Updates server with now playing information
  • Interfaces with Bluetooth remote control clients and Pebble watches
  • Interfaces with apps that implement the Scrobble Droid interface (Simple Scrobbler is my scrobbler of choice) for scrobbling to or
  • Intuitive layout

Download on the Google Play Store

Requires JRiver Media Center running on your home server


Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.


Java SDK 8+ and the Android SDK are required to develop project blue. To perform a continuous integration (CI) build, Docker and Docker Compose are required.


  1. Clone this repository
  2. Install Android Studio, along with the Android SDK
  3. Build and run!

Running the tests

Run the tests via the IDE.

Running the Build

Android Studio can perform the build. To run a CI build like it is run in Github, run the following command:



Once changes are merged, a build will be deployed and published by the project blue maintainer.

Built With

  • Gradle - Dependency and Build Management
  • Android Studio and SDK - Tools and standard library for Android
  • Kotlin - Language project blue is migrating to
  • Java - Majority of the project is written in Java
  • Handoff - Continuations library


All code considered guilty until proven innocent! Please ensure that your code is proven with unit tests before submitting a PR. No PR will be considered without the tests to back it up.

All new changes should be written in Kotlin if possible.

Folder structure is organized by feature, or rather, it doesn't use the "sock drawer" folder structure that Android follows. It is inspired by this post on AngularJS project structure (another Google framework that encourage sock drawer app structuring): This means everything is logically grouped in nested folders based on feature. Unfortunately, some areas, such as the res folders, do not allow such structuring.

Finding issues and reporting them is also contributing to making project blue better! Please submit any issues that are found in the issues area.

Please read for more details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. For the versions available, see the tags on this repository.


  • David Vedvick


This project is licensed under the GNU Lesser General Public License v3.0 - see the LICENSE file for details.



Alternative streaming music player for J River Media Center





No packages published