Skip to Content

ASTRION SERIES · SUPPORT GUIDE

Music Assistant Configuration

Connect your Astrion remote to Music Assistant (MA), configure access tokens, and control your audio ecosystem seamlessly.

Note: Astrion remotes are compatible with Music Assistant. Please ensure your remote is already added to the Astrion Home Integration before proceeding. Also note that MA and ROS (RosCard) are independent applications. Local shortcuts configured in ROS do not automatically apply to MA.
01

Open MA & Login

On your Astrion remote's home screen, pull down and tap the MA icon, or go to Settings → Music Assistant.

Open MA from the home screen or Settings

On the MA entry page, tap to log in. You can access the URL provided on the screen via a browser, or scan the QR code with your phone.

MA login entry QR code and access URL
02

Enter Connection Details

Ensure your remote, the scanning phone, and the MA server are on the same network.

Open the login page and fill in the Music Assistant server IP, Port, and Access Token.

  • Server IP: The IP address of the device running MA (e.g., 192.168.0.127).
  • Port: The MA service port (e.g., 8095).
  • Token: Create a new token in the MA admin page (Settings → Users → Create long-lived token).
Important: Tokens are usually only displayed once. Copy and save it immediately. If lost, you must create a new one.

Submit the details. Once connected, the remote will load the MA main interface.

Enter server information on the remote login page
Create a Token in the MA Admin settings
MA main interface after successful login
03

Settings & Hardware Shortcuts

Click the Music Assistant title in the top left corner to open the settings menu. Here you can view connection info, disconnect, scan for a new server, or configure the lyrics screensaver.

Astrion Remote Hardware Key Mapping:

Model Previous Play / Pause Stop Next Volume
HA100ALight buttonCurtain buttonMusic buttonAC buttonVol +/-
HA100BPrev buttonPlay/Stop buttonStop buttonNext buttonVol +/-
Astrion ProPrev buttonPlay/Stop buttonStop buttonNext buttonVol +/-
X9 Vela————Vol +/-

Note: Button mappings depend on the current firmware and MA version.

MA Settings menu and Lyrics Screensaver
04

Mini Player Operations

The MA mini-player on the remote allows you to quickly switch entities, group players, and open album details.

  • Switch Playback Entity: Swipe left or right on the mini player.
  • Select Player: Tap the current playback entity name to open the player selection list.
  • Group Players: Tap the speaker icon area to open the temporary grouping interface.
  • Album Details: Tap the album cover to enter the album/playback detail page.
Swipe left/right to switch entities
Tap to open the player selection list
Select players for temporary grouping
05

Add HA Media Player to MA

To use the remote's Media Player entity in MA, you need to add the Home Assistant MediaPlayers provider.

  1. Go to Settings → Player providers → Home Assistant MediaPlayers.
  2. In the Player entities dropdown, select the Media Player entity corresponding to your remote.
  3. If you have multiple remotes, identify the correct one by checking the entity name or device ID.
Navigate to Home Assistant MediaPlayers provider
Select the Media Player from the entity list
!

Common Issues & Tips

  • MA black screen / won't launch: Exit MA and reopen it.
  • Switch MA servers: Inside MA, tap the top-left title, then scan the QR code of the new server.
  • Initial lag: MA is loading data. Give it a moment.
  • Token lost: You must create a new long-lived token.
  • Return to ROS: Just press the back button.
  • Data not syncing: Changes made in the MA web interface won't instantly appear on the remote. Perform a "pull down" gesture on the screen (not the refresh button in the menu) to update.
Back to Astrion Support