focuscast

A terminal UI application that automatically shows/hides OBS scene items based on which window is currently focused.

Features

• Monitors the active window in real-time
• Automatically enables/disables OBS scene items based on configurable mappings
• TUI interface for creating and managing window-to-source mappings
• Persists configuration to disk

Requirements

• OBS Studio with WebSocket server enabled (v5.x)
• Rust toolchain (for building from source)

Installation

cargo install --path .

Or build manually:

cargo build --release

The binary will be at target/release/focuscast.

Configuration

Configuration is stored at:

• macOS: ~/Library/Application Support/focuscast/config.json
• Linux: ~/.config/focuscast/config.json
• Windows: %APPDATA%\focuscast\config.json

Example Configuration

{
  "obs": {
    "host": "127.0.0.1",
    "port": 4455,
    "password": "your-obs-websocket-password"
  },
  "mappings": {
    "Scene Name": [
      {
        "app_name": "Firefox",
        "source_name": "Browser Capture"
      },
      {
        "app_name": "Terminal",
        "source_name": "Terminal Capture"
      }
    ]
  }
}

OBS Connection Settings

The obs section is optional. If omitted, defaults to 127.0.0.1:4455 with no password.

Usage

1. Enable the OBS WebSocket server in OBS Studio (Tools > WebSocket Server Settings)
2. Configure the connection in config.json if needed
3. Run the application:

obs-focus-win

Keyboard Controls

Config Screen

How It Works

1. The app connects to OBS via WebSocket
2. It monitors the currently focused window on your system
3. When the focused window matches a configured mapping, it enables that scene item and disables others in the mapping group
4. Scene changes in OBS are detected automatically and mappings are re-applied

License

MIT