obs_rename_input
Rename an OBS source to a new name not already in use. Scene references follow automatically, but external automations using the old name will not.
Instructions
Rename a source. Inside OBS this is safe and complete: scene items reference the source itself, not its name, so every scene follows the rename and nothing breaks visually.
Outside OBS it is the opposite, and that is the real risk. Everything that automates OBS addresses sources BY NAME over the websocket - health checks asking whether a mic is producing sound, audio tooling, scene builders, and every tool call in this server. None of them are updated by a rename, none of them fail loudly, and the symptom arrives later as 'that check stopped reporting' rather than as an error. A source name that has drifted from what it now shows is often still worth keeping for exactly this reason. Prefer renaming the SCENE, which nothing addresses by name, or leaving it alone.
Names are unique across the whole collection, so a rename onto a name already in use fails.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputName | Yes | Current exact input name. | |
| newInputName | Yes | New name. Must not already be in use by another input. |