status

Monitor the current runtime state of sunsetr via IPC.

Usage

sunsetr status
sunsetr status --json
sunsetr status --follow
sunsetr status --json --follow

Flags

  • --json, -j: Output in JSON format for scripting
  • --follow, -f: Stream real-time state changes continuously

One-Shot Mode (Default)

Displays current state once and exits:

sunsetr status

Output:

 Active preset: default
Current period: Sunset 󰖛 (32.19%)
         State: transitioning
   Temperature: 5470K → 3300K
         Gamma: 96.8% → 90.0%
   Next period: 17:49:25 (in 31m)

Follow Mode

Stream real-time state changes:

sunsetr status --follow

Events displayed:

  • StateApplied: Temperature/gamma updates
  • PeriodChanged: Period transitions (Day → Sunset → Night → Sunrise)
  • PresetChanged: Preset switching

JSON Output

Machine-readable output for scripting:

sunsetr status --json

{
  "active_preset": "default",
  "period": "sunset",
  "state": "transitioning",
  "progress": 0.4637135,
  "current_temp": 5016,
  "current_gamma": 95.36286,
  "target_temp": 3300,
  "target_gamma": 90.0,
  "next_period": "2025-11-11T17:49:25.000679991-06:00"
}

Use Cases

  • Verify sunsetr is running correctly
  • Monitor transition progress and timing
  • Status bar integration (waybar, quickshell, etc.)
  • Automating changes in your UI or other applications

IPC Socket

The IPC can be used directly with a custom client or you can use the status command in follow and json mode (sunsetr -f -j) using something like jq. The IPC is located at:

$XDG_RUNTIME_DIR/sunsetr-events.sock
# Typically: /run/user/1000/sunsetr-events.sock

Notes