### CLI DDC Value Parsing Formats

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/5.0.3.md

Examples of supported hex and decimal formats for CLI DDC values.

```text
0x1F
```

```text
x1F
```

```text
1Fh
```

--------------------------------

### Brightness Control - Set and Get Brightness

Source: https://context7.com/alin23/lunar/llms.txt

Control monitor brightness using hardware DDC commands or software methods. Brightness values range from 0-100, with support for relative adjustments using +/- operators.

```APIDOC
## [POST/PUT] /api/displays/{display_selector}/brightness

### Description
Sets or gets the brightness level for specified displays.

### Method
POST or PUT

### Endpoint
/api/displays/{display_selector}/brightness

### Parameters
#### Path Parameters
- **display_selector** (string) - Required - Selector for the target display(s) (e.g., `external`, `main`, `cursor`, `dell`, `"LG UltraFine"`).

#### Query Parameters
- **brightness_value** (integer or string) - Required for setting - The desired brightness level (0-100) or a relative adjustment (e.g., `+10`, `-5`).

### Request Example
```bash
# Set brightness for all external displays to 70%
lunar displays external brightness 70

# Get current brightness of main display
lunar displays main brightness

# Increase brightness by 10 points
lunar displays cursor brightness +10

# Decrease brightness by 5 points
lunar displays dell brightness -5

# Set brightness for a specific display by name
lunar displays "LG UltraFine" brightness 80

# Set normalized brightness (0.0-1.0 range)
lunar displays external normalizedBrightness 0.75

# Quick set/get using shortcuts
lunar set brightness 60
lunar get brightness
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message or the current brightness value.

#### Response Example
```json
{
  "message": "Brightness set to 70 for external displays."
}
```
```

--------------------------------

### Get API Key for Remote Control

Source: https://context7.com/alin23/lunar/llms.txt

Obtain the API key required for authenticating remote control commands. This key is essential for establishing a secure connection to a remote Lunar instance.

```bash
lunar key
```

--------------------------------

### List and Query Displays via CLI

Source: https://context7.com/alin23/lunar/llms.txt

Retrieve information about connected monitors, including hardware capabilities and current settings.

```bash
# List all active displays with their properties
lunar displays

# Output format:
# 0: LG UltraFine 4K
#     ID:                 1234567890
#     Serial:             ABC123-DEF456-...
#     Brightness:         75
#     Contrast:           70
#     Volume:             50
#     Has DDC:            true
#     Has I2C:            true

# Get display info as JSON
lunar displays --json

# Filter by display name (fuzzy matching)
lunar displays dell

# Filter by specific display selectors
lunar displays external        # All external displays
lunar displays builtin         # Built-in display only
lunar displays cursor          # Display with cursor
lunar displays main            # Main display
lunar displays first           # First active display

# Include additional metadata
lunar displays --system-info --panel-data --edid
```

--------------------------------

### React to display connection changes

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.4.0.md

Enable the listen command to react to display connection changes.

```bash
lunar listen
```

--------------------------------

### Apply Brightness Presets

Source: https://context7.com/alin23/lunar/llms.txt

Apply predefined percentage-based or named brightness and contrast presets.

```bash
# Apply a percentage preset (0-100)
lunar preset 75

# Apply a custom preset by name
lunar preset "Movie Mode"
lunar preset "Night Work"
```

--------------------------------

### Listen for Display State Changes

Source: https://context7.com/alin23/lunar/llms.txt

Subscribe to real-time updates for brightness, contrast, and volume changes, with optional JSON output.

```bash
# Listen for all display changes
lunar listen

# Listen with JSON output
lunar listen --json

# Listen to specific displays
lunar listen external
lunar listen dell

# Listen only to user adjustments (keyboard/mouse)
lunar listen --only-user-adjustments
```

--------------------------------

### Configure Wireless Sensor Connection Settings

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.0.0.md

Use the defaults command to customize the hostname, port, and path prefix for external ambient light sensors.

```sh
defaults write fyi.lunar.Lunar sensorHostname homeassistant.local
defaults write fyi.lunar.Lunar sensorPort 8123
defaults write fyi.lunar.Lunar sensorPathPrefix /lunar
```

--------------------------------

### Configure Blackout Mode

Source: https://context7.com/alin23/lunar/llms.txt

Enable blackout mode for external displays with optional mirroring configuration.

```bash
lunar blackout external enable --no-mirror
```

```bash
lunar blackout dell enable --master main
```

--------------------------------

### Switch Input via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/4.8.0.md

Use this command to switch the input source of a display. Fuzzy matching for display names is supported.

```bash
lunar displays ultrafine input hdmi
```

--------------------------------

### Switch Monitor Inputs

Source: https://context7.com/alin23/lunar/llms.txt

Change active video inputs or configure hotkey inputs for supported monitors.

```bash
# Switch to HDMI 1
lunar displays external input hdmi1

# Switch to DisplayPort
lunar displays dell input displayport1

# Switch to USB-C/Thunderbolt
lunar displays external input usbc1
lunar displays external input thunderbolt1

# Available input names:
# hdmi1, hdmi2, hdmi3, hdmi4
# displayport1, displayport2 (or dp1, dp2)
# usbc1, usbc2, usbc3 (or thunderbolt1, thunderbolt2, thunderbolt3)
# vga1, vga2, dvi1, dvi2

# Configure hotkey inputs for quick switching
lunar displays external hotkeyInput1 hdmi1
lunar displays external hotkeyInput2 displayport1
lunar displays external hotkeyInput3 usbc1
```

--------------------------------

### Set input source via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.9.6.md

Use this command to programmatically set the display input source to a specific device string.

```bash
lunar set input "HDMI 1 (LG specific)"
```

--------------------------------

### Switch LG Monitor Input via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.2.0b2.md

Use this command to switch inputs on compatible LG monitors. Ensure the monitor supports LG-specific input switching.

```sh
lunar displays lg input lgHdmi1
```

--------------------------------

### Read Display Contrast via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/4.8.0.md

Use this command to read the contrast value of a display. Fuzzy matching for display names is supported.

```bash
lunar displays dell34 contrast
```

--------------------------------

### Enable ambient light sensor automation

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.4.0.md

Use this command to trigger automations based on readings from the internal ambient light sensor.

```bash
lunar lux --listen
```

--------------------------------

### Set Main Monitor via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.7.2b2.md

Use this command to designate a specific monitor as the main display using the Lunar CLI.

```bash
lunar displays LG main true
```

--------------------------------

### Display Management API

Source: https://context7.com/alin23/lunar/llms.txt

Commands for managing display properties such as rotation, brightness, and contrast.

```APIDOC
## CLI Display Management

### Description
Manage display orientation and hardware properties.

### Usage
- `lunar displays <filter> rotation <value>` - Change screen orientation (0, 90, 180, 270)
- `lunar displays <filter> <property> [value]` - Read or write display properties

### Supported Properties
- **brightness** (0-100)
- **contrast** (0-100)
- **volume** (0-100)
- **rotation** (0/90/180/270)
- **input** (Video source)
- **power** (on/off)
```

--------------------------------

### Display Management - List and Query Displays

Source: https://context7.com/alin23/lunar/llms.txt

Provides comprehensive information about connected monitors, including their current brightness, contrast, volume settings, and hardware capabilities.

```APIDOC
## GET /api/displays

### Description
Retrieves a list of all connected displays with their properties.

### Method
GET

### Endpoint
/api/displays

### Parameters
#### Query Parameters
- **--json** (boolean) - Optional - Output the display information in JSON format.
- **[display_name]** (string) - Optional - Filter displays by name (fuzzy matching).
- **[display_selector]** (string) - Optional - Filter displays by selector (e.g., `external`, `builtin`, `cursor`, `main`, `first`).
- **--system-info** (boolean) - Optional - Include system-level information.
- **--panel-data** (boolean) - Optional - Include panel-specific data.
- **--edid** (boolean) - Optional - Include Extended Display Identification Data (EDID).

### Request Example
```bash
lunar displays
lunar displays --json
lunar displays dell
lunar displays external
lunar displays --system-info --panel-data --edid
```

### Response
#### Success Response (200)
- **display_id** (string) - Unique identifier for the display.
- **serial** (string) - Serial number of the display.
- **brightness** (integer) - Current brightness level (0-100).
- **contrast** (integer) - Current contrast level (0-100).
- **volume** (integer) - Current volume level (0-100).
- **has_ddc** (boolean) - Indicates if the display supports DDC.
- **has_i2c** (boolean) - Indicates if the display supports I2C.

#### Response Example
```json
[
  {
    "id": "1234567890",
    "serial": "ABC123-DEF456-GHI789",
    "brightness": 75,
    "contrast": 70,
    "volume": 50,
    "has_ddc": true,
    "has_i2c": true
  }
]
```
```

--------------------------------

### Facelight Mode API

Source: https://context7.com/alin23/lunar/llms.txt

Commands to turn monitors into light panels for video calls.

```APIDOC
## CLI Facelight Mode

### Description
Turn monitors into bright light panels.

### Usage
- `lunar facelight <filter> enable` - Enable Facelight mode
- `lunar facelight <filter> disable` - Disable Facelight mode
```

--------------------------------

### Execute DDC Raw Commands

Source: https://context7.com/alin23/lunar/llms.txt

Send low-level DDC/CI commands to monitors for advanced control of features like brightness, contrast, and input sources.

```bash
# Read current brightness value (VCP 0x10)
lunar ddc external 0x10 read

# Read max brightness value
lunar ddc external brightness readmax

# Write brightness value directly
lunar ddc external brightness 75

# Read contrast (VCP 0x12)
lunar ddc "LG UltraFine" contrast read

# Write with hex values
lunar ddc external 0x60 0x11 --hex

# Use named control IDs
lunar ddc main INPUT_SOURCE read
lunar ddc main AUDIO_SPEAKER_VOLUME 50
```

--------------------------------

### Send Command to Remote Lunar Instance

Source: https://context7.com/alin23/lunar/llms.txt

Execute commands on a remote Lunar instance by specifying the host and API key. This allows for centralized control of multiple displays across different machines.

```bash
lunar displays external brightness 70 --remote --host 192.168.1.100 --key ABC123
```

```bash
lunar blackout builtin enable --remote --host mac-mini.local --key YOUR_API_KEY
```

--------------------------------

### Input Switching - Change Monitor Inputs

Source: https://context7.com/alin23/lunar/llms.txt

Switch between video inputs (HDMI, DisplayPort, USB-C/Thunderbolt) on supported monitors.

```APIDOC
## [POST/PUT] /api/displays/{display_selector}/input

### Description
Switches the active input source for specified displays.

### Method
POST or PUT

### Endpoint
/api/displays/{display_selector}/input

### Parameters
#### Path Parameters
- **display_selector** (string) - Required - Selector for the target display(s) (e.g., `external`, `dell`).

#### Query Parameters
- **input_source** (string) - Required - The desired input source (e.g., `hdmi1`, `displayport1`, `usbc1`, `thunderbolt1`).

### Request Example
```bash
# Switch to HDMI 1
lunar displays external input hdmi1

# Switch to DisplayPort
lunar displays dell input displayport1

# Switch to USB-C/Thunderbolt
lunar displays external input usbc1
lunar displays external input thunderbolt1

# Configure hotkey inputs for quick switching
lunar displays external hotkeyInput1 hdmi1
lunar displays external hotkeyInput2 displayport1
lunar displays external hotkeyInput3 usbc1
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating the input switch.

#### Response Example
```json
{
  "message": "Input switched to hdmi1 for external displays."
}
```
```

--------------------------------

### Manage Cleaning Mode

Source: https://context7.com/alin23/lunar/llms.txt

Black out screens and disable keyboard input for cleaning, with configurable timeouts.

```bash
# Enable Cleaning Mode (auto-deactivates after 120 seconds)
lunar cleaning-mode on

# Enable with custom timeout
lunar cleaning-mode on --deactivate-after 60

# Keep active until manually disabled
lunar cleaning-mode on --keep-active

# Disable Cleaning Mode
lunar cleaning-mode off
```

--------------------------------

### Enable Facelight on Specific Display

Source: https://context7.com/alin23/lunar/llms.txt

Enable Facelight mode on a particular display by specifying its name. This allows for targeted control of lighting effects.

```bash
lunar facelight dell enable
```

--------------------------------

### Set Adaptive Brightness Modes

Source: https://context7.com/alin23/lunar/llms.txt

Configure how Lunar automatically adjusts display brightness based on various inputs or schedules.

```bash
# Set to Sync Mode (follows built-in display brightness)
lunar mode sync

# Set to Location Mode (sunrise/sunset based)
lunar mode location

# Set to Sensor Mode (ambient light sensor)
lunar mode sensor

# Set to Clock Mode (time-based schedules)
lunar mode clock

# Set to Manual Mode (no automatic adjustments)
lunar mode manual

# Auto mode (Lunar chooses best mode)
lunar mode auto

# Print the learned brightness mapping for a mode
lunar mode sync --print-mapping
```

--------------------------------

### Set Ambient Light Sensor Hostname

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/5.8.1a1.md

Use this command to change the hostname of the ambient light sensor. Ensure the new hostname is valid and accessible on your network.

```shell
defaults write fyi.lunar.Lunar sensorHostname mysensor.local
```

--------------------------------

### Manage Monitor Brightness

Source: https://context7.com/alin23/lunar/llms.txt

Adjust brightness levels using absolute values, relative increments, or normalized ranges.

```bash
# Set brightness for all external displays to 70%
lunar displays external brightness 70

# Get current brightness of main display
lunar displays main brightness

# Increase brightness by 10 points
lunar displays cursor brightness +10

# Decrease brightness by 5 points
lunar displays dell brightness -5

# Set brightness for a specific display by name
lunar displays "LG UltraFine" brightness 80

# Set normalized brightness (0.0-1.0 range)
lunar displays external normalizedBrightness 0.75

# Quick set/get using shortcuts
lunar set brightness 60           # Set on best-guess display
lunar get brightness              # Get from best-guess display
```

--------------------------------

### Switch LG monitor inputs via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.2.0.md

Use the lunar displays command to switch inputs on supported LG monitors. Note that input numbering varies by model, requiring trial of different indices.

```sh
lunar displays lg input lgHdmi1

# Newly added inputs:
#   lgHdmi1 lgHdmi2 lgHdmi3 lgHdmi4
#   lgUsbC1 lgUsbC2 lgUsbC3 lgUsbC4
#   lgDisplayPort1 lgDisplayPort2 lgDisplayPort3 lgDisplayPort4
```

--------------------------------

### Control Monitor Volume

Source: https://context7.com/alin23/lunar/llms.txt

Manage audio settings and mute states for external monitors supporting DDC audio.

```bash
# Set volume to 50%
lunar displays external volume 50

# Mute display audio
lunar displays external audioMuted true

# Toggle mute state
lunar displays main audioMuted toggle

# Get current volume
lunar displays dell volume
```

--------------------------------

### List of LG Specific Inputs

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.2.0b2.md

These are the newly added LG specific inputs that can be controlled via the CLI. They are available for monitors that require specific commands for input switching.

```sh
# Newly added inputs:
#   lgHdmi1 lgHdmi2 lgHdmi3 lgHdmi4
#   lgDisplayPort1 lgDisplayPort2
#   lgUsbC1 lgUsbC2
```

--------------------------------

### Enable Facelight on External Displays

Source: https://context7.com/alin23/lunar/llms.txt

Activate Facelight mode on all external displays. This feature turns monitors into light panels, suitable for video calls or ambient lighting.

```bash
lunar facelight external enable
```

--------------------------------

### Enable BlackOut Mode

Source: https://context7.com/alin23/lunar/llms.txt

Turn off specific monitors to focus on others or disable built-in displays.

```bash
# Turn off the built-in display
lunar blackout builtin enable

# Turn off a specific external display
lunar blackout dell enable

# Re-enable a blacked-out display
lunar blackout builtin disable
```

--------------------------------

### Enable DDC and Disable Apple Native Control via CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.9.2.md

Use this command to simultaneously enable DDC control and disable Apple Native control for specific displays. This is useful for fine-tuning display protocols through the command line.

```bash
lunar displays ultrafine appleNativeEnabled off; lunar displays builtin ddcEnabled on
```

--------------------------------

### Adjust Monitor Contrast

Source: https://context7.com/alin23/lunar/llms.txt

Modify hardware contrast levels using DDC commands with support for relative and normalized adjustments.

```bash
# Set contrast for external displays
lunar displays external contrast 65

# Get contrast value
lunar displays main contrast

# Relative adjustments
lunar displays cursor contrast +5
lunar displays cursor contrast -10

# Set normalized contrast (0.0-1.0 range)
lunar displays external normalizedContrast 0.7
```

--------------------------------

### Manage Display Connections

Source: https://context7.com/alin23/lunar/llms.txt

Disconnect or reconnect displays on Apple Silicon Macs without physical cable changes.

```bash
# Disconnect the built-in display
lunar disconnect builtin

# Reconnect the built-in display
lunar connect builtin

# Disconnect a specific external display
lunar disconnect dell

# Reconnect all disconnected displays
lunar connect all

# Toggle connection state
lunar toggle-connection builtin

# Force disconnect even with single screen
lunar disconnect builtin --force
```

--------------------------------

### Read Ambient Light Sensor Values

Source: https://context7.com/alin23/lunar/llms.txt

Retrieve current or averaged lux readings from built-in or external sensors.

```bash
# Get current lux reading
lunar lux

# Get averaged lux (last 15 readings)
lunar lux --average

# Listen for continuous lux changes
lunar lux --listen
```

--------------------------------

### Remote Control API

Source: https://context7.com/alin23/lunar/llms.txt

Commands for controlling Lunar instances on other Macs over the network.

```APIDOC
## CLI Remote Control

### Description
Control Lunar instances running on other Macs over the network using an API key.

### Usage
- `lunar key` - Get API key for remote control
- `lunar <command> --remote --host <ip/hostname> --key <api_key>` - Execute command on remote instance
```

--------------------------------

### Adjust Gamma and Color Temperature

Source: https://context7.com/alin23/lunar/llms.txt

Modify display gamma values for color temperature control, with options for persistence and restoration.

```bash
# Read current gamma values
lunar gamma --display external

# Set gamma values (requires keeping process running)
lunar gamma --write --red 0.8 --green 0.85 --blue 1.0 --display external

# Reset gamma to defaults
lunar gamma --reset --display main

# Restore ColorSync settings
lunar gamma --restore-color-sync

# Set gamma with auto-refresh interval
lunar gamma --write --red 0.9 --green 0.9 --blue 1.0 --refresh-seconds 2

# Keep gamma active for specific duration
lunar gamma --write --red 0.8 --green 0.85 --blue 0.9 --wait 300
```

--------------------------------

### Read EDID for Specific Display

Source: https://context7.com/alin23/lunar/llms.txt

Fetch the EDID information for a specific display by its name. This is useful for diagnosing compatibility issues or gathering precise hardware details.

```bash
lunar edid dell
```

--------------------------------

### Rotate Display to Landscape Mode

Source: https://context7.com/alin23/lunar/llms.txt

Reset the display orientation to the default landscape mode by setting the rotation to 0 degrees. This is the standard orientation for most displays.

```bash
lunar displays external rotation 0
```

--------------------------------

### Enable Jitter After Wake via Terminal

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/5.0.3.md

Activates the Jitter After Wake function for monitors that wake up with dimmed brightness.

```bash
defaults write fyi.lunar.Lunar jitterAfterWake 1
```

--------------------------------

### Contrast Control - Adjust Monitor Contrast

Source: https://context7.com/alin23/lunar/llms.txt

Adjust hardware contrast levels on monitors that support DDC contrast control. Works similarly to brightness with the same selectors and operators.

```APIDOC
## [POST/PUT] /api/displays/{display_selector}/contrast

### Description
Sets or gets the contrast level for specified displays.

### Method
POST or PUT

### Endpoint
/api/displays/{display_selector}/contrast

### Parameters
#### Path Parameters
- **display_selector** (string) - Required - Selector for the target display(s) (e.g., `external`, `main`, `cursor`, `dell`).

#### Query Parameters
- **contrast_value** (integer or string) - Required for setting - The desired contrast level (0-100) or a relative adjustment (e.g., `+5`, `-10`).

### Request Example
```bash
# Set contrast for external displays
lunar displays external contrast 65

# Get contrast value
lunar displays main contrast

# Relative adjustments
lunar displays cursor contrast +5
lunar displays cursor contrast -10

# Set normalized contrast (0.0-1.0 range)
lunar displays external normalizedContrast 0.7
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message or the current contrast value.

#### Response Example
```json
{
  "message": "Contrast set to 65 for external displays."
}
```
```

--------------------------------

### Toggle Night Mode

Source: https://context7.com/alin23/lunar/llms.txt

Activate or deactivate Night Mode to reduce eye strain.

```bash
# Enable Night Mode
lunar night-mode on

# Disable Night Mode
lunar night-mode off

# Toggle Night Mode
lunar night-mode toggle
```

--------------------------------

### Rotate Display to Portrait Mode

Source: https://context7.com/alin23/lunar/llms.txt

Change the orientation of a display to portrait mode by setting the rotation to 90 degrees. This command is useful for adapting screen orientation to specific content or workspace needs.

```bash
lunar displays main rotation 90
```

--------------------------------

### View Lunar logs in terminal

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.0.0b6.md

Use this command to stream debug logs for the Lunar subsystem in the terminal.

```bash
log stream --level debug --source --style compact --predicate 'subsystem == "fyi.lunar.Lunar" AND category == "default"'
```

--------------------------------

### Volume Control - Monitor Audio Settings

Source: https://context7.com/alin23/lunar/llms.txt

Control the built-in speakers of external monitors that support audio over DDC. Includes mute/unmute functionality.

```APIDOC
## [POST/PUT] /api/displays/{display_selector}/volume

### Description
Sets or gets the volume level for specified displays, and controls mute state.

### Method
POST or PUT

### Endpoint
/api/displays/{display_selector}/volume

### Parameters
#### Path Parameters
- **display_selector** (string) - Required - Selector for the target display(s) (e.g., `external`, `dell`).

#### Query Parameters
- **volume_value** (integer) - Required for setting - The desired volume level (0-100).
- **audioMuted** (boolean or string) - Required for mute control - Set to `true` to mute, `false` to unmute, or `toggle` to switch state.

### Request Example
```bash
# Set volume to 50%
lunar displays external volume 50

# Mute display audio
lunar displays external audioMuted true

# Toggle mute state
lunar displays main audioMuted toggle

# Get current volume
lunar displays dell volume
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message or the current volume/mute status.

#### Response Example
```json
{
  "message": "Volume set to 50 for external displays."
}
```
```

--------------------------------

### Set Display Rotation

Source: https://context7.com/alin23/lunar/llms.txt

Set the rotation of a display to a specific angle. Supported values are 0, 90, 180, and 270 degrees, allowing for flexible screen orientation adjustments.

```bash
lunar displays cursor rotation 180
```

--------------------------------

### Read EDID for All External Displays

Source: https://context7.com/alin23/lunar/llms.txt

Retrieve and decode the EDID (Extended Display Identification Data) for all connected external monitors. This provides detailed information about the display's capabilities.

```bash
lunar edid
```

--------------------------------

### Disable 'Bad Display' Detection

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/6.7.14b2.md

Use this command to disable the 'bad display' detection feature by setting `ignoreDisplaysWithMissingMetadata` to false. This is useful for specific troubleshooting scenarios.

```sh
defaults write fyi.lunar.Lunar ignoreDisplaysWithMissingMetadata false
```

--------------------------------

### EDID Information API

Source: https://context7.com/alin23/lunar/llms.txt

Commands to read and decode display EDID data.

```APIDOC
## CLI EDID Information

### Description
Read and decode Extended Display Identification Data from monitors.

### Usage
- `lunar edid` - Read EDID for all external displays
- `lunar edid <filter>` - Read EDID for a specific display
```

--------------------------------

### Disable Facelight

Source: https://context7.com/alin23/lunar/llms.txt

Turn off Facelight mode on external displays. This command reverts the display's light panel functionality to its normal state.

```bash
lunar facelight external disable
```

--------------------------------

### Force Hex Parsing in CLI

Source: https://github.com/alin23/lunar/blob/master/ReleaseNotes/5.0.3.md

Flag to ensure CLI values are always parsed as hexadecimal.

```bash
--hex
```

--------------------------------

### BlackOut Mode - Turn Off Displays

Source: https://context7.com/alin23/lunar/llms.txt

BlackOut mode allows turning off specific monitors while keeping others active. Useful for focusing on a single screen or turning off the built-in display when using external monitors.

```APIDOC
## [POST/PUT] /api/blackout/{display_selector}

### Description
Enables or disables BlackOut mode for specified displays, effectively turning them off or on.

### Method
POST or PUT

### Endpoint
/api/blackout/{display_selector}

### Parameters
#### Path Parameters
- **display_selector** (string) - Required - Selector for the target display(s) (e.g., `builtin`, `dell`).

#### Query Parameters
- **state** (string) - Required - The desired state: `enable` to turn off, `disable` to turn on.

### Request Example
```bash
# Turn off the built-in display
lunar blackout builtin enable

# Turn off a specific external display
lunar blackout dell enable

# Re-enable a blacked-out display
lunar blackout builtin disable
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating the BlackOut mode status change.

#### Response Example
```json
{
  "message": "BlackOut mode enabled for builtin display."
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.