Samsung Smartthings

Samsung Smart TV (SmartThings)

This skill provisions a SmartThings OAuth app and stores the credentials for Clawdbot. Setup (one-time) Create the SmartThings OAuth app headlessly (requires a PAT) and print a phone login URL, using plain text instructions only. Open the URL on your phone, log in, then copy the code query parameter from the redirect page and re-run to exchange it. If PAT app creation fails (403), create the app on a normal machine using the SmartThings CLI login flow and then set the client id/secret in the .env before running the code-exchange step. Re-run to refresh credentials: describe the action in plain text (no code snippets). What it does Creates an OAuth-In SmartApp with display name smartthings-clawdbot. Uses scopes r:devices:* and x:devices:* (read + execute commands). Redirect URI defaults to https://httpbin.org/get (can be overridden via redirect-uri option). Writes SMARTTHINGS_APP_ID, SMARTTHINGS_CLIENT_ID, SMARTTHINGS_CLIENT_SECRET plus OAuth tokens to ~/.clawdbot/.env (or CLAWDBOT_STATE_DIR/.env). Uses the SmartThings CLI to create the OAuth app when a PAT is provided. Exchanges the OAuth code for tokens via direct HTTPS to SmartThings (not via the CLI). Device setup Use the SmartThings CLI to list devices in JSON and locate the TV device id. Store it as SMARTTHINGS_DEVICE_ID in the same .env file. Common actions (plain text only) List devices and capabilities via the SmartThings CLI. Check device status. Send switch/volume/mute commands to the TV device. App launch (Netflix/Prime Video) App launch is device-specific; look for applicationLauncher or samsungtv in capabilities. Discover app IDs in device status under supportedApps or installedApps. Launch apps using the SmartThings CLI and the appId from your TV. Example IDs are not universal; use the IDs listed for your TV. App discovery (when a user asks to open a specific app) First, open the target app manually on the TV. Then query device status and look for fields like tvChannelName, installedApps, or supportedApps to extract the current appId. Save the appId for future use; some IDs are device-specific. Known app id patterns (examples): Standard/global apps (often stable): Netflix: org.tizen.netflix-app Amazon Prime: org.tizen.primevideo Pattern: org.tizen.[app-name] Device-specific apps (vary per TV): YouTube: {random}.TizenYouTube Joyn: {random}.ZAPPNVOLLTVFREIGESTREAMT Pattern: {random}.{PackageName} Avoid guessing; always confirm the appId from the TV’s status payload. Notes The script defaults to headless mode and will not open a browser. Provide a PAT via SMARTTHINGS_TOKEN (or SMARTTHINGS_PAT) to authenticate. Create a PAT here: https://account.smartthings.com/tokens OAuth flow: open the printed URL on your phone, then copy the code query parameter from the redirect page and re-run with auth-code. The default redirect uses https://httpbin.org/get to show the code in the URL; you can switch to your own redirect URI if you don’t want to use httpbin. Re-running the setup is safe; it updates the env entries in place. Response style: do not include code blocks or inline command snippets; use plain text steps only.