Skip to content

Commit 18e4c32

Browse files
Merge pull request #103 from OzGav/main
Minor changes I missed
2 parents 49d2d67 + bed060f commit 18e4c32

File tree

5 files changed

+29
-13
lines changed

5 files changed

+29
-13
lines changed

docs/assets/beta-testing.png

1.61 KB
Loading
69.8 KB
Loading

docs/faq/groups.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,41 +3,48 @@ title: Frequently Asked Questions - Groups
33
description: Player Grouping Functionality in Music Assistant
44
---
55

6-
# Manual Sync
6+
# Groups
7+
8+
!!! warning "Note"
9+
Do not delete or disable a player which is in a group while the group is playing
10+
11+
## Manual Sync
712

813
These are temporary group players that are configured via the [Player List](ui.md#player-list).
914

10-
## Features
15+
### Features
1116

1217
- Players can dynamically be added or removed before or during playback
1318
- The HA action [media_player.join](https://www.home-assistant.io/integrations/media_player/#action-media_playerjoin) can be used to create this type of group
1419

15-
## Known Issues / Notes
20+
### Known Issues / Notes
1621

1722
- Players can be linked via the chain icon in the [Player List](../ui.md#player-list)
1823
- Only like player types that support synced playback are allowed to be joined. These players will then play in sync
1924
- When players are grouped in this way only the main player holds the queue. For example, player A has an existing queue and players B and C are joined to player A. If player A is turned off players B and C will stop
2025
- Some player types may pause momentarily as a new device is joined
2126

22-
# Sync Groups
27+
## Sync Groups
2328

2429
These are permanent group players that are configured via the MA settings. These should be used when the make up of the group will rarely change.
2530

26-
## Features
31+
![image](assets/screenshots/syncgroup.png)
32+
33+
### Features
2734

2835
- The native player types shown (i.e. not the Universal Group option) support perfect sync (this is a requirement to be shown in the list)
2936
- In addition to playing in sync the group will hold the queue regardless of which player(s) in the group are powered off
3037

31-
## Known Issues / Notes
38+
### Known Issues / Notes
3239

3340
- As mentioned above the group player holds the queue rather than any individual player, however, if the group leader is lost then playback will stop but the queue can be restarted
3441
- The group will not power on if one of the child players is synced to another group
3542

36-
# Universal Groups
43+
## Universal Groups
3744

3845
Music Assistant has support for grouping dissimilar playback devices.
3946

40-
## Features
47+
### Features
4148

4249
All devices (except Chromecast) can be grouped but not all will play in sync. See the individual players for their limitations.
4350

@@ -46,7 +53,7 @@ All devices (except Chromecast) can be grouped but not all will play in sync. Se
4653

4754
![image](../assets/screenshots/universal-group.png)
4855

49-
## Known Issues / Notes
56+
### Known Issues / Notes
5057

5158
- This type of group should be avoided if a [Sync Group or Native Group](../ui.md#grouping-players) can be used
5259
- Universal Groups can include sync groups but not other universal groups

docs/music-providers/deezer.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,19 @@ Music Assistant has support for [Deezer](https://www.deezer.com/). Contributed a
1717
- Radio mode (Similar to Deezer flow)
1818

1919
## Configuration
20-
Login by pressing the `Authenticate` button when adding the provider in the Music Assistant interface.
20+
21+
Authentication with Deezer happens through an Access and ARL Token. Unfortunately, Deezer does not officially support third party logins, so you will need to obtain your own ARL Token. Instructions were written for Chrome:
22+
23+
1. in the MA SETTINGS select ADD MUSIC PROVIDER and then DEEZER.
24+
2. Launch the authentication process by pressing the `Authenticate` button
25+
3. Login to Deezer on the popup window
26+
4. After logging in the MA settings page will have the ACCESS TOKEN automatically populated but the ARL TOKEN now needs to be manually obtained
27+
5. Navigate in another browser tab to [https://deezer.com/](https://deezer.com/)
28+
6. Right click on the browser window and select INSPECT. A new window will open
29+
7. Click the 'Application' tab. You might need to expand your window or click the `>>` button
30+
8. Under Storage > Cookies, click "https://www.deezer.com" and find the entry labelled "arl"
31+
![Preview image](../assets/screenshots/deezer-arl.png)
32+
9. Copy the cookie value and use this in Music Assistant as the 'ARL TOKEN'
2133

2234
**If this does not work ensure that you:**
2335
- Are on the same network as Music Assistant

docs/ui.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,6 @@ There are four ways to group players
6262

6363
1. **[MANUAL SYNC.](faq/groups.md#manual-sync)** As shown in the [Player List](#player-list) section players can be linked via the chain icon in the player list. Only like player types that support synced playback are allowed to be joined. These players will then play in sync. It should be noted that when players are grouped in this way only the main player holds the queue.
6464
2. **[SYNC GROUP.](faq/groups.md#sync-groups)** Create a (permanent) group player via the settings. In addition to playing in sync the group will also keep the queue on the group player instead of one of its child players.
65-
66-
![image](assets/screenshots/syncgroup.png)
67-
6865
3. **[UNIVERSAL GROUP.](player-support/universal.md#universal-groups)** This allows grouping of dissimilar player provider types but carefully note the potentional limitations on the linked page.
6966
4. **NATIVE GROUP.** Use the native functionality to group players offered by some player provider types (e.g. Google Cast)
7067

0 commit comments

Comments
 (0)