Groups.xml
The groups.xml describes all of the players on your system.
It is used by the Players and the Acquire Advanced Editor.
Players are placed in groups.
Each Player has a number of outputs.
An annotated example is shown below.
⚠️This file is created by the Acquire Advanced Configuration app and should not be edited manually
<!--
Groups
cms_datetimeformat: format of datetime in the CMS row summary
(default "MMM dd, yyyy HH:mm")
cms_grouplistcellwidth,
cms_grouplistcellheight: size of cells in group list screens (Status & Player Switcher)
(default 150 x 80)
tcp: true/false, use TCP communication, otherwise UDP
debug:extra logging etc. in the Editor
cms_screenshotallscreens:screenshots on CMS status screen gets all screens? else just main
cms_screenshotquality:if screenshots on CMS status screen
cms_addplayerstop2p:add new players to rdserver.ini
-->
<groups cms_datetimeformat="MMM-dd-yyyy HH:mm" cms_grouplistcellwidth="150" cms_grouplistcellheight="80" cms_screenshotallscreens="false" cms_screenshotquality="90" tcp="false" debug="true" cms_addplayerstop2p="true">
<!--
Group
- A group of players, eg: "all columns" or "pilon" or something
- Each group of players can have one or more playlists
- For Example, for Cosmo: Lobby, Talon, Chelsea
name: as an id in the playlist, and to show in the CMS - must be
unique!
cms_playlistrowheight: this group's playlist's row height in the CMS (px)
(default 80)
lat,
lng:latitude/longitude of this group
cms_updatedbyeditor:set by editor when adding visualisations etc.
-->
<group name="Lobby" cms_playlistrowheight="80" lat="36.18811" lng="-115.176468" cms_updatedbyeditor="true">
<!--
Player
- A Player PC
- In the CMS, each player is one column in the group's playlist
- Player Settings:
name: User-visible name for the player (eg: column 1)
id: Unique Player ID (players use kiosk id which can be
overriden by a playerid.txt in the neversend folder)
server: for TCP mode, the players' TCP server address
port: for TCP mode, the player's TCP server port (def. -1)
portrs: for TCP connection to Remote Screen (currently not exposed in Setup)
backupplayerid: ID of the backup player that will impersonate "id" if the
"id" stops working
backupserver: as "server" but for backup player
backupport: as "port" but for backup player
backupportrs: as "portrs" but for backup player
sync: Sync Mode (1=Transmitter)
If = 1 then other players in this group will sync there
playback with this player.
cms_playlistcolwidth: the player's column width in the Editor (px)
(default 100)
NOTE: the outputs are shown scaled down to fit in the Editor
playlist row cell (cms_playlistcolwidth x
cms_playlistcolheight) so, those sizes must be large
enough to accomodate all outputs.
cms_isnew: for internal Setup app used only: the player is new so do special one-off stuff
and mark as not new
-->
<player name="column 1" id="1" server="192.168.0.225" port="0" portrs="1968" backupplayerid="2" backupserver="192.168.7.90" backupport="0" backupportrs="1968" sync="0" cms_playlistcolwidth="150" cms_isnew="false">
<!--
Player Output
- In the CMS, each output will be one media drop-point in a column of the
group's playlist
- Its up to the player to actually work out how to output this,
but if a player output several videos per line in the playlist they are
defined here
- Player Output Settings:
name: A name to identify which output it is, eg: "North
side", this must match on the player config file
width: The width of the output in pixels
height: The height of the output in pixels
cms_allowanysizemedia: in the Editor you can normally only drop media into an
output if it has the same dims as that output.
setting this to true allows ANY size media to be
dropped on the output
(default=false)
cms_locked: do not edit in the Configuration app (toggled in that app)
cms_linksizes: the Configuration app, the this content size always matches the output size
cms_testCardFile: a test card image (grid+circles+text) to use for this output when the Editor makes the test playlist
created\saved by the config app and sized to the actual output
cms_swatchFile: an colour swatch image (HLS grid) to use for this output when the Editor makes the test playlist
created\saved by the config app and sized to the output's content size
-->
<output name="a" width="" height="" cms_allowanysizemedia="true" cms_locked="false" cms_linksizes="true" cms_testCardFile="testcard_Output 1_1920_1080.png" cms_swatchFile="swatch_Output 1_1920_1080.png"/>
<output name="b" width="" height=""/>
<output name="c" width="" height=""/>
<output name="d" width="" height=""/>
</player>
</group>
</groups>