Stream Groups

A Stream Group is a folder that organizes a Source's Streams in the sidebar. A Source like "Cerbo GX" can have a few Streams directly beneath it plus one or more groups - say "test Streams" - that hold the rest. Groups can be nested inside other groups, as deep as you like.

Grouping is purely for tidiness: a grouped Stream still belongs to its Source and tails exactly the same way. Moving a Stream into a group changes only where it appears in the sidebar.

Creating a group

Right-click a Source and choose 'New Stream Group…' to add a group directly under it.
Right-click an existing Stream Group and choose 'New Group…' to create a group nested inside it.

Give the group a name and an SF Symbol, just like a Source Group.

Adding Streams to a group

Two ways, whichever you prefer:

Drag a Stream onto a group folder to move it in; drag it back onto the Source row to take it out again.
Or right-click a Stream and use 'Move to Group' ▸, then pick a group (or None to ungroup it). Nested groups appear as "Parent ▸ Child".

Drag Streams up and down to reorder them within a group, and drag a group folder onto another to re-nest it (you can't drop a folder into one of its own descendants).

Viewing a group

Select a Stream Group to see a summary of its contents - its nested groups and Streams - in the detail pane. Double-click an item there to open it.

Status at a glance when collapsed

When you collapse a group, its folder shows a single status LED that rolls up the Streams hidden inside it - so you can keep groups closed to save space and still see if something needs attention:

Green when every Stream inside is streaming normally.
Yellow / orange when a Stream is connecting or reconnecting.
Red the moment any Stream hits an error.
Gray when every Stream inside is stopped.

The worst status wins, and it propagates upward: a red Stream deep inside a nested group turns its group red, its Source red, and the Source's group red too - all the way to the top. Expand a container again and the LED disappears, since each Stream then shows its own. The same roll-up applies to collapsed Source Groups and Sources. The waveform rolls up alongside it, so a closed container beats while anything inside is receiving.

Deleting a group

Right-click a group and choose 'Delete Group'. The group and any nested groups are removed, but the Streams themselves are never deleted - they simply move back up to the Source. Every action here - create, rename, move, delete - can be undone with ⌘Z.