DISPLAY

The DISPLAY block controls PpRx's live terminal/status display. These settings affect how receiver status, bank/channel tracking information, and diagnostic messages are formatted and refreshed on screen; they do not affect acquisition, tracking, or estimator behavior.

Below is an example of the DISPLAY block:

[DISPLAY]
DISPLAY_EXTRA_FIELDS = FALSE
REDRAW_PERIOD = 2

The DISPLAY block contains all of the following configuration parameters:

USE_COLOR

Default: True
Parameter Class: Display Configuration
Technical Info: Enables ANSI color formatting for the terminal display when output is written to stdout.
Practical Tuning Info: Leave enabled for interactive terminal use. Disable if display output is being redirected to a file.

MESSAGE_PRINTING_PERSISTENCE

Default: 5
Parameter Class: Display Configuration
Technical Info: Number of display refreshes that a diagnostic/status message remains visible before being removed from the display cache.
Practical Tuning Info: Increase to display status messages for longer.

DISPLAY_EXTRA_FIELDS

Default: False
Parameter Class: Display Configuration
Technical Info: Enables additional per-channel display fields, such as phase-lock and tracking-quality details.
Practical Tuning Info: Leave disabled for the normal compact display. Enable when debugging tracking behavior or when additional channel-level diagnostics are useful.

MAXIMUM_BANK_COLUMNS

Default: 2
Parameter Class: Display Configuration
Technical Info: Maximum number of bank display columns shown in a single display row.
Practical Tuning Info: Increase on wide terminals to show more banks side by side.

WRAP_BANK_ROWS

Default: False
Parameter Class: Display Configuration
Technical Info: Controls what happens when multiple banks of the same signal type exceed MAXIMUM_BANK_COLUMNS. When true, additional banks wrap to a new row; when false, banks that do not fit are not displayed.
Practical Tuning Info: Enable when all bank displays should remain visible, especially in multi-antenna or multi-signal configurations.

MIX_BANK_ROWS

Default: False
Parameter Class: Display Configuration
Technical Info: Controls whether banks with different signal types may share the same display row. When false, different signal types start on separate rows; when true, different signal types may share a row up to MAXIMUM_BANK_COLUMNS.
Practical Tuning Info: Enable to make the display more compact. This setting only affects row layout; WRAP_BANK_ROWS separately controls whether same-type banks that exceed MAXIMUM_BANK_COLUMNS are wrapped or hidden.

REDRAW_PERIOD

Default: 1
Parameter Class: Display Configuration
Technical Info: The display is redrawn every REDRAW_PERIOD log intervals (with a log interval being set by --log-interval in the .opt file).
Practical Tuning Info: Leave at 1 for normal use. Increase if display output is too frequent or terminal redraw overhead is significant.