Cmdlet

Set-ConsoleSetting

Module: ConsoleMonster

Changes a ConsoleMonster setting for this session, and with -Save for every session.

Syntax

Set-ConsoleSetting
[-Name] <String>
[-Save]
[-Value] <String>
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

Sets Theme, Color, Glyphs, Border, Density, StatusMarkers, Motion, Mouse, Accessible, Hyperlinks, Language or Culture. Border, Density and StatusMarkers override the theme's own style: the frame around panels, tables and inputs, Comfortable or Compact spacing, and Symbols or Words ([OK] [FAIL] [WARN]) for statuses. Compact reduces default padding and gaps; explicit spacing stays as authored. The value applies at once to everything ConsoleMonster draws in this session, above any CONSOLEMONSTER_* environment variable. -Save also writes it to the settings file, so new sessions and other tools built on ConsoleMonster use it too; nothing needs to be added to your profile. Theme takes a built-in theme, a catalogue scheme or paired family, or the path of a .json or .psd1 theme file (see Export-ConsoleTheme). Store an accessible catalogue choice with its suffix, for example Dracula · accessible. Show-ConsoleSetting chooses settings with a live preview.

Examples

Example 1

Set-ConsoleSetting Theme ColorBlindSafe -Save

Use the colour-blind-safe theme from now on

Example 2

Set-ConsoleSetting Motion Reduced; Set-ConsoleSetting Mouse Off

Keep animations still and leave the mouse to the terminal, for this session only

Example 3

Set-ConsoleSetting Border Single -Save; Set-ConsoleSetting StatusMarkers Words -Save

Square frames and status words instead of symbols, from now on

Example 4

# Requires an existing team-theme.json file, for example from Export-ConsoleTheme.
Set-ConsoleSetting Theme ./team-theme.json -Save

Use a team theme file in every session

Parameters

-Name String requiredposition: 0: The setting: Theme, Color, Glyphs, Border, Density, StatusMarkers, Motion, Mouse, Accessible, Hyperlinks, Language or Culture.
-Save SwitchParameter optional: Also writes the value to the settings file, for every new session.
-Value String requiredposition: 1: The value. Get-ConsoleSetting lists the values each setting takes; Theme also takes a theme file path; catalogue choices can end in · accessible. Language and Culture take a culture name such as pl or de-DE.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.