Guide / Controls / Readouts

Log

Lines of messages as they arrive

When to use it. A scrolling terminal-style log viewer. Displays timestamped log lines pushed via sync, with color-coded severity levels and monospace rendering.

Type
logConsole
Also titled
Log Console
Default size
3 rows × 4 columns
Symbol
terminal.fill
Docs
Docs complete
Search for it as
  • console
  • log
  • terminal
  • output
  • messages
  • tail
Log: Application log viewer
Rendered by the app

Fields

10 fields you can set on a logConsole control. Every control also takes the shared fields (id, position, span, sync, action).

Fields
FieldTypeDefaultWhat it does
Titlelabeltext—

The name shown above the log

Shows this text in the header above the console, next to a count of the lines kept.

Stylestylechoiceone of 2default

Dark panel or see-through

Picks whether the lines sit on the theme's second background fill or on a clear background.

  • default defaultthe lines sit on a filled panel
  • transparentno panel fill, so the card behind shows through
Lines keptmaxLinesnumber10–1000step 10200

How many lines to remember

Shows only this many of the newest lines; older ones scroll away.

TimestampsshowTimestampson / offtrue (on)

Show the time on each line

Puts the time (hours, minutes, seconds) in front of every line when on.

Text sizefontSizenumber8–28step 111

How big the text is

Sets the size of the monospace text on every line.

Auto-scrollautoScrollon / offtrue (on)

Follow the newest line

Keeps the view pinned to the latest line as new ones arrive, until you drag up to read older ones.

HeightcontrolHeightnumber80–800step 10—

How tall the log is

Sets the height of the console area in points; without it the area stays compact at no more than 200.

logColorslogColorsobject—

Colors for each kind of message

Colors each line by its level name, for example error or warn, overriding the theme's built-in level colors.

Colortintcolor#667eea

The accent color

Stores an accent color for the console; lines take their colors from the level colors and the theme, so it shows no change today.

defaultValuedefaultValuelist—

Starting messages shown until new ones arrive

Fills the console with these lines before any synced line arrives.

Emits and receives

What this control sends when you use it, and what it can show or follow when data arrives.

Receives

Receives
TakesFromTypeWhat it does
linesshowhub, mqtt, http, store, defaultjson

one log line per message, a text and an optional level

each message adds a line at the bottom, colored by its level; the oldest lines drop off past the line limit, and the view follows the newest line unless auto-scroll is off

Example: {"text": "Sample A"}

Sample

The placeholder value the editor shows before real data arrives.

  • {"text": "Sample A"} then {"text": "Sample B"}

Examples

3 examples, each one a control you can paste into a layout.

Application log viewer

JSON 18 lines
{
  "type": "logConsole",
  "id": "app-logs",
  "position": [0, 0],
  "span": [3, 4],
  "label": "Application Logs",
  "maxLines": 500,
  "showTimestamps": true,
  "fontSize": 12,
  "autoScroll": true,
  "logColors": {
    "error": "#FF3B30",
    "warn": "#FF9500",
    "info": "#34C759",
    "debug": "#8E8E93"
  },
  "sync": [{ "method": "meshsocket", "type": "listen", "event": "broadcast", "filter": { "msg_type": "log_stream" } }]
}

Open in CAR-TER

Each server broadcast {"msg_type": "log_stream", "text": "…", "level": "warn"} appends one line. With no valuePath the whole frame is read, so text (or line/message) and level both land.

Log: Application log viewer
Rendered by the app

Quiet transparent log

Small, see-through log that shows no times and the newest lines only.

JSON 11 lines
{
  "type": "logConsole",
  "id": "quiet-log",
  "position": [0, 0],
  "span": [3, 2],
  "label": "Events",
  "style": "transparent",
  "showTimestamps": false,
  "maxLines": 50,
  "fontSize": 10
}

Open in CAR-TER

Seeded log with custom level colors

Starts with two lines and colors errors and successes your own way.

JSON 11 lines
{
  "type": "logConsole",
  "id": "seeded-log",
  "position": [0, 0],
  "span": [3, 4],
  "label": "Deploy",
  "controlHeight": 300,
  "autoScroll": true,
  "logColors": { "error": "#FF453A", "success": "#30D158" },
  "defaultValue": ["Waiting for deploy...", { "text": "Last run failed", "level": "error" }]
}

Open in CAR-TER

Try it on your phone

carterkit serves a small hub on your computer and pushes one example to CAR-TER on your iPhone or iPad. Pair once with the code it prints.

  1. Install the Python kit.

    pip install carterkit
  2. Show “Application log viewer” on your phone.

    carterkit demo logConsole --example 'Application log viewer'
  3. Swap in any example name from this page, or leave --example off for the first one.

carterkit quickstart · Get CAR-TER

For a full ANSI terminal — raw escape-code colour/bold, pane-width auto-scaling and pinch-to-zoom (e.g. mirroring a captured shell/tmux pane) — use a Border thickness with style: "terminal" instead. The log console is line-oriented (level colours), not an escape-code renderer.

Generated from ControlDocs/log-console.md. Something unclear or missing? Tell me.