Create an OBS overlay widget
create_obs_widgetBuild a ready-to-paste Browser source URL for OBS, Streamlabs, Meld or TikTok LIVE Studio: a countdown (fixed length or until a date), a stream uptime timer, a clock in any time zone, or a goal progress bar (manual value or live TikTok follower count). Widgets are transparent, free and keep all settings in the URL, so nothing is stored. Returns the URL, the source width and height, setup steps and a link to fine-tune it visually.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"widget": "<widget>"
},
"name": "create_obs_widget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| font | No | Google Font for the text (default Inter). | |
| goal | No | goal_bar: target number (default 100). | |
| size | No | Text size in px. | |
| color | No | Text colour, hex like #ffffff. | |
| label | No | countdown / stream_timer: text above the time, e.g. "Starting soon" or "Live for". | |
| title | No | goal_bar: title, default "Follower goal". | |
| until | No | countdown: count down to this ISO 8601 date-time with UTC offset, e.g. 2026-12-31T20:00:00-05:00. | |
| hour12 | No | clock: 12-hour clock with AM/PM. | |
| widget | Yes | ||
| current | No | goal_bar: current number for a manual bar. | |
| minutes | No | countdown: length in minutes (default 5). Ignored when "until" is set. | |
| seconds | No | clock: show seconds. | |
| end_text | No | countdown: text shown when it reaches zero (default "We're live!"). | |
| timezone | No | clock: IANA time zone such as "Europe/Warsaw". Defaults to the computer running OBS. | |
| show_date | No | clock: show the date. | |
| show_days | No | countdown / stream_timer: show days for long durations. | |
| hide_at_end | No | countdown: hide the widget when it ends. | |
| accent_color | No | countdown: progress bar colour; goal_bar: bar start colour. | |
| progress_bar | No | countdown: show a progress bar. | |
| show_timezone | No | clock: show the time zone name. | |
| accent_color_2 | No | goal_bar: bar end colour (gradient). | |
| tiktok_username | No | goal_bar: follow a TikTok account's live follower count instead of a manual number. |