BluAS, album shuffle controller for BluOS

Introduction
BluAS stands for BluOS Album Shuffle and is an Android app controller that allows you to control your BluOS player at home. Its main function is to select and play complete albums randomly selected from your local network. BluAS is particularly interesting for users with (very) large music collections.

The official BluOS Controller mobile app doesn't (yet) offer such an "album shuffle" function, while users with large music collections would like this (see here). The BluAS Android app uses the publicly available API, which you can find here. The initial implementation was developed as a Python script and a more interactive webpage version, both are still available upon request.

How to install
You can download the latest version of the app from this download page and install it on your Android device (Android 8+). The latest version is v0.95f.

To communicate with your BluOS player, a number of technical parameters must match your local situation (via the app's technical settings):

• IP address of your BluOS player within your local network (Check Diagnostic info of your Controller app)
• Portno to which the API of your BluOS-player listens to (default 11000)
• Service name of your music library on your NAS (default LocalMusic)

PhD Software offers a free version (max. 250 artists, max. 3 albums per artist, no autoplay and track mode) and a paid licensed version.

How it works
First, an artist is randomly selected, so that every artist on your NAS has an equal chance. Second, an album is randomly selected and played. BluAS uses an own index containing all your available artists and its genre. This allows a quick selection of the albums!

To control album playback (and visualize album playback durations with progress bars), BluAS does not allow simultaneous control of other controllers (such as the BluOS controller app). When BluAS takes control by selecting and playing an album, the status becomes set by BluAS.

If BluAS detects another app being used, it returns to an unset status, the progress bars disappear, the autoplay mode stops, and... the Artist button turns to red.

Button layout overview
Artist	Shuffle	Skip	Play	Vol. up
Album	Repeat	Back	Info	Vol. down

How to use
When you start the player for the first time and have set the correct technical parameters, you can check the status of your BluOS device with the Info button. If everything looks allright, you can create your BluAS index: press the Artist button, click ok and wait for BluAS to finish creating the index (can take some time).

Clicking the Artist button randomly selects a new artist, and clicking the Album button randomly selects another album by the previously selected artist. Long-pressing the Info button displays the tracklist of the album currently playing on BluAS (not available if the app status is unset).

Additionally, the combination of the Shuffle button and Repeat button determines the autoplay mode, when BluAS continues with playing another album after an album has finished playing.

• Shuffle only, player will play random album of a random artist
• Shuffle+Repeat, player will play random album of the current artist
• Repeat only, player will replay current album of the current artist

The Autoplay mode requires the app to remain active in the background. It starts a so-called foreground activity (in the status bar) and requires unrestricted battery usage for the app (Android 12+).

Although BluAS is an album controller, it offers with the Track mode the feature to autoplay just one track from a selected album, chosen at random, of course.

The Autoplay feature is an unique way to randomly play music from your library. There is no need to create playlists in advance, as this takes away the element of surprise!

Filters
To refine the random selection of albums, two filters are available. In the first field (top left), you can select a genre. You can also exclude a genre by prefixing it with a minus character. By entering a q, a popup appears with the avaliable genres and its number of artists held by BluAS. In the second field (to the right of the first field), you can select an artist from whom you want to play random albums. You can search by parts of a genre or artist name. But to select specific artist names, you may prefix your search text with a dot. Example: use '.Yes' to find artist Yes or 'Yes' to find f.i. 'Bright Eyes'.

Nice to know
The index created by and within BluAS is based on BluOS indexing results. If you've added a new artist, be sure to reindex your music library using the BluOS app first. It's also important to note that BluAS uses an artist-centric approach. While an artist can belong to multiple genres, BluAS can only select them based on one genre.

BluAS can also display the album's year, if it's included in the album's file path on your network folder.

BluAS plays a randomly selected album by default without any confirmation, which can be changed in the settings. The Autoplay mode and Track mode can also be enabled through the settings. You can use the app in light or dark mode through the settings.

BluOS compatibility
The app is at least compatible with BluOS firmware version 4.10.13 (July 2025). Since there is no way to revert to previous BluOS firmware versions, there is a small risk that upgrades may cause compatibility issues. Therefore, PhD Software greatly appreciates all comments and feedback.

License, custom version or support?
For a license, custom version, special requests or questions, please send an email to info@phdsoftware.nl.

BluAS screen examples