Skip to content

Commit e542748

Browse files
Merge pull request #101 from OzGav/groups
2 parents 82efe66 + fa88bac commit e542748

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

docs/ui.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -58,14 +58,19 @@ If mutiple players in a group are being streamed to then this is shown by a numb
5858

5959
![image](assets/screenshots/group_indication.png)
6060

61-
There are three ways to group players
61+
There are four ways to group players
6262

63-
1. As shown in the previous section players can be linked via the 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. 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 also stop.
64-
2. Create a group player via the settings. The native player types shown (i.e. not the Universal Group option) support perfect sync (this is a requirement to be shown here). In addition to playing in sync the group will also keep playing regardless of which player(s) in the group are powered off. So the group player holds the queue rather than any individual player.
63+
1. **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. 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 also stop. This type of group is created when the HA action [media_player.join](https://www.home-assistant.io/integrations/media_player/#action-media_playerjoin) is used.
64+
2. **SYNC GROUP.** Create a group player via the settings. The native player types shown (i.e. not the Universal Group option) support perfect sync (this is a requirement to be shown here). In addition to playing in sync the group will also keep playing regardless of which player(s) in the group are powered off. So the group player holds the queue rather than any individual player.
6565

66-
![image](assets/screenshots/syncgroup.png)
66+
![image](assets/screenshots/syncgroup.png)
67+
68+
3. **[UNIVERSAL GROUP.](player-support/universal.md)** This allows grouping of dissimilar player provider types but carefully note the potentional limitations on the linked page.
69+
4. **NATIVE GROUP.** Use the native functionality to group players offered by some player provider types (e.g. Google Cast)
70+
71+
!!! warning "Important"
72+
Do not attempt to group other groups. Doing so will likely result in unpredicatable behaviour. Future MA versions may support this in limited circumstances.
6773

68-
3. Create a [Universal Group](player-support/universal.md)
6974
***************************************************************
7075

7176
## Artist / Album / Track View

0 commit comments

Comments
 (0)