Network screen map — owners, sources and components

Developer documentation is maintained in English in both handbook editions. Use the translation menu for another language. Code and receiver screenshots remain in English.

A screen name is a lookup key, not a promise that all older widgets still exist. Begin with the Python class that owns the screen. Check its self["..."] assignments, its base classes and its skinName selection before writing XML.

Source widgets and named widgets

<!-- List is a Source: it needs a renderer and a template. -->
<widget source="adapterList" render="Listbox"
    position="20,20" size="1060,250">
  <template name="Default" fonts="Regular;24" itemHeight="50">
    <rowtemplate>
      <text index="AdapterName" position="0,0" size="1060,50" font="0" />
    </rowtemplate>
    <rowtemplate>
      <text index="AdapterName" position="0,0" size="1060,50" font="0" />
    </rowtemplate>
  </template>
</widget>

<!-- The scan screen owns a Label component, not a StaticText source. -->
<widget name="description" position="20,400" size="1060,45"
    font="Regular;22" />

The first fragment belongs to NetworkOverview; the second belongs to NetworkWiFiScan or NetworkShares. They are not a complete screen to combine indiscriminately. name="description" connects to an existing GUI component. source="savedLabel" render="Label" connects a renderer to a Source. These forms are not interchangeable.

Complete class map

Extracted from source revision f4135659cb. Components below are declared by each class itself; inherited Setup, help and information components are explained in the next chapter.

Python screen / source	Base / setup key	Locally declared visual components
NetworkOverview	Screen, ProtectedScreen	savedLabel — StaticText key_red — StaticText key_green — StaticText key_yellow — StaticText key_blue — StaticText key_menu — StaticText key_info — StaticText adapterList — List savedList — List
NetworkAdapterSetup	Setup Setup key: NetworkAdapter	key_info — StaticText
NetworkWiFiSetup	Setup Setup key: NetworkWiFi	key_info — StaticText
NetworkInformation	InformationNetwork
NetworkWiFiScan	Screen	list — List description — Label key_red — StaticText key_green — StaticText key_yellow — StaticText
NetworkWiFiActivator	Screen	status — Label key_red — StaticText
NetworkTest	Screen	key_red — StaticText key_green — StaticText list — List
DNSSettings	Setup Setup key: DNS	key_yellow — StaticText key_blue — StaticText
NetworkMountsOverview	Screen	mountList — List key_red — StaticText key_green — StaticText key_yellow — StaticText key_menu — StaticText
NetworkMountsSummary	ScreenSummary	entry — StaticText value — StaticText
NetworkMountSetup	Setup Setup key: NetworkMounts
NetworkShares	Screen	list — List description — Label key_red — StaticText key_green — StaticText key_yellow — StaticText key_menu — StaticText
NetworkCredentials	Setup Setup key: NetworkCredentials
NetworkServicesSetup	Setup, NetworkDaemons Setup key: NetworkServicesSetup	key_yellow — StaticText key_blue — StaticText
NetworkInadynSetup	Setup Setup key: NetworkInadynSetup
NetworkuShareSetup	Setup Setup key: NetworkuShareSetup	key_yellow — StaticText
uShareSelection	Screen	key_red — StaticText key_green — StaticText key_yellow — StaticText checkList — self.filelist
NetworkMiniDLNASetup	Setup Setup key: NetworkMiniDLNASetup	key_yellow — StaticText
NetworkNFSSetup	Setup Setup key: NetworkNFS	key_yellow — StaticText
NetworkSambaSetup	Setup Setup key: NetworkSamba
NetworkPassword	Setup Setup key: Password	key_yellow — StaticText
NetworkLogScreen	Screen	infotext — ScrollLabel
NetworkZeroTierSetup	Setup Setup key: NetworkZeroTier	key_yellow — StaticText key_blue — StaticText
RestartNetwork	Screen, ProtectedScreen

actions, infoActions and similar action maps receive keys; they are not visual widgets. key_red, key_green and the other key_... sources provide the current captions. The screen may set a caption to an empty string when an action is unavailable. Use ConditionalShowHide to preserve that behaviour instead of painting a permanent caption.

Inheritance matters

• Setup subclasses inherit the config component, description, footnote, editing support and standard key sources. Their lookup sequence is explained in forms and auxiliary screens.
• NetworkInformation inherits InformationNetwork. Its visible text is the inherited information ScrollLabel; there is no adapterList in this screen.
• NetworkMountsSummary selects SetupSummary and provides entry and value for the front-panel summary. It is not the television mount list.
• uShareSelection exposes checkList, backed by MultiFileSelectList. A generic network row template is not its rendering interface.
• NetworkLogScreen exposes infotext, a ScrollLabel. It first tries its caller-selected skin name, then NetworkLogScreen.
• RestartNetwork selects DUMMY and uses the shared Processing overlay. Enlarging its zero-size fallback does not implement a network progress screen.

Keep the content area, key bar and optional context/help indicators as separate layout regions. A named panel can share their geometry, but it must only reference sources that exist in every owner using it. Guard optional components with conditional as the common Setup fallback does.