# ToneCast for OBS Studio

Use OBS as a ToneCast screen — cast photos, video, timers, text, and webpages into your stream or recording.

## Quick start (script)

1. Download [`tonecast.lua`](tonecast.lua)
2. In OBS: **Tools → Scripts → +** and select the file
3. Set:
   - **Base URL** — `https://tonecast.net` (or your local Desktop cast host)
   - **Account slug** — from ToneCast Dashboard (account public slug)
   - **Screen number** — e.g. `1`
4. Click **Add / Update ToneCast Source**

A Browser Source is added to your current scene at 1920×1080 (configurable).

## Manual Browser Source

If you prefer not to use the script:

1. In OBS: **Sources → + → Browser**
2. URL:

```
https://tonecast.net/cast.html?a=YOUR_SLUG&screen=1&obs=1
```

3. Width / Height: match your canvas (often 1920×1080)
4. Check **Control audio via OBS** if you want ToneCast audio in the mixer
5. Optional custom CSS:

```css
body { margin: 0; overflow: hidden; background: #000; }
```

The `obs=1` flag hides cast chrome (fullscreen button, etc.) for a clean source.

## Setup helper

Open [obs.html](../../obs.html) on tonecast.net while signed in to copy a ready-made URL for your account.

## Requirements

- Official OBS Studio build with **Browser Source** (included on Windows / macOS / official Linux packages)
- A ToneCast account and at least one screen