Skip to content

(Widget) Obs

github-actions edited this page Jan 13, 2025 · 2 revisions

OBS Widget Options

ObsWidget is a custom widget that integrates with OBS (Open Broadcaster Software) via WebSocket to display and control recording status.

Option Type Default Description
connection dict {host: "192.168.1.5", port: 4455, password: "123456"} Connection info for OBS WebSocket Server
icons dict {recording: "\ueba7", stopped: "\ueba5", paused: "\ueba7"} The alternative format string for the label. Useful for displaying additional notification details.
hide_when_not_recording boolean true Hide widget when OBS and recording are not running.
blinking_icon boolean true Blink icons when recording is active.
container_padding dict {'top': 0, 'left': 0, 'bottom': 0, 'right': 0} Explicitly set padding inside widget container.

Example Configuration

obs:
  type: "yasb.obs.ObsWidget"
  options:  
    connection:
      host: "192.168.1.5"
      port: 4455
      password: "123456"
    icons:
      recording: "\ueba7"
      stopped: "\ueba5"
      paused: "\ueba7"
    hide_when_not_recording: true
    blinking_icon: true

Description of Options

  • connection: Connection info for OBS WebSocket Server. Go to Tools -> WebSocket Server Settings in OBS to enable the WebSocket server.
  • icons: Icons for different recording states.
  • hide_when_not_recording: Hide widget when OBS and recording are not running.
  • blinking_icon: Blink icons when recording is active.
  • container_padding: Explicitly set padding inside widget container. Use this option to set padding inside the widget container. You can set padding for top, left, bottom and right sides of the widget container.

Example Style

.obs-widget  {
    padding: 0 5px;
}
.obs-widget .recording {
    font-size: 18px;
    color: #ff3b3b;
}
.obs-widget .paused {
    font-size: 18px;
    color: #bfc93b;
}
.obs-widget .stopped {
    font-size: 18px;
    color: #756e70;
}
Clone this wiki locally