Displays: UI & Theming

Use these query parameters to control the HTML5 Display client’s visual presentation: window decorations, toolbar visibility, menu icon, dark mode, floating menu, clock, and browser title bar content. These parameters are accepted by the versioned API endpoint and are ideal for kiosk deployments, dashboards, and embedded display scenarios where the client UI should be tailored to the use case.

Access Display Client

GET /api/v1/display/

Serves the HTML5 Display client web interface with optional URL-based configuration. This is the versioned API equivalent of the root display endpoint and accepts the same query parameters for full client customization.

Parameters

Name	In	Type	Required	Description
`decorations`	query	boolean	No	Show window decorations (title bar with close/minimize/maximize buttons). Set to `false` for headless/kiosk mode. Default: `true`
`toolbar`	query	boolean	No	Show entire toolbar/menu area (menu trigger + menu). Set to `false` to hide all menu UI elements. Takes precedence over the `menu` parameter. Default: `true`
`menu`	query	boolean	No	Show Hoody menu trigger icon. Set to `false` to hide menu completely. Note: `toolbar` parameter takes precedence over this. Default: `true`
`dark_mode`	query	boolean	No	Enable dark mode theme. Default: `false`
`floating_menu`	query	boolean	No	Show floating menu. Default: `true`
`clock`	query	boolean	No	Show server clock. Default: `true`
`title_show_hoody`	query	boolean	No	Show “Hoody” in browser title. Default: `true`
`title_show_display_id`	query	boolean	No	Show display ID in browser title. Default: `true`

Response

<!DOCTYPE html>
<html>
<head><title>Hoody Display Client</title></head>
<body>
  <!-- Display HTML5 client interface -->
</body>
</html>

Example Request

curl -X GET "https://myproject-mycontainer-display-1.node1.containers.hoody.icu/api/v1/display/?decorations=false&toolbar=false&dark_mode=true&floating_menu=true&clock=true&title_show_hoody=true&title_show_display_id=true"

cURL
SDK

curl -X GET "https://myproject-mycontainer-display-1.node1.containers.hoody.icu/api/v1/display/?decorations=false&toolbar=false&dark_mode=true&floating_menu=true&clock=true&title_show_hoody=true&title_show_display_id=true"

await client.display.accessClient({
  decorations: false,
  toolbar: false,
  dark_mode: true,
  floating_menu: true,
  clock: true,
  title_show_hoody: true,
  title_show_display_id: true,
});