samsung-smart-tv

What This Skill Does

The Samsung Smart TV skill leverages the SmartThings API to provide comprehensive control over your Samsung television. This skill handles the intricate setup of a SmartThings OAuth application, allowing your AI agent to authenticate and interact with your TV. It securely stores the necessary credentials, including API keys and OAuth tokens, in a local .env file for seamless operation. The skill enables a wide range of functionalities, from basic device status checks and media controls (volume, mute) to launching specific applications like Netflix or Prime Video. It intelligently discovers and utilizes app IDs specific to your TV model, ensuring reliable app launching.

Installation

To install the Samsung Smart TV skill, follow these steps:

1. Install the skill: Use the clawhub command to install the skill from its source repository:

   clawhub install openclaw/skills/skills/regenrek/samsung-smartthings
   

2. **One-time Setup (OAuth App Provisioning):

   • Option A (Recommended - Headless with PAT): If you have a Personal Access Token (PAT) for SmartThings, you can create the OAuth app automatically. The skill will guide you through this process, providing a phone login URL. Open this URL on your phone, log in to your Samsung account, and then copy the code query parameter from the redirect page. Re-run the setup command with this code to exchange it for necessary OAuth tokens.
   • Option B (Manual - If PAT Fails): If the headless creation fails (often due to a 403 error), you may need to create the OAuth app manually on a computer with the SmartThings CLI installed. Follow the SmartThings CLI's login flow to create the app. Once created, locate the client_id and client_secret and add them to your .env file (located in ~/.clawdbot/ or $CLAWDBOT_STATE_DIR/). Then, proceed with the code exchange step as described in Option A.

3. Device Setup: Use the SmartThings CLI to list your devices and identify your TV's unique device_id. Store this ID in your .env file as SMARTTHINGS_DEVICE_ID.

4. Refresh Credentials: To refresh your OAuth tokens, simply re-run the skill's refresh command. The skill will handle the token exchange process automatically.

Use Cases

• Control TV Power and Volume: Turn your TV on/off, adjust the volume, and mute/unmute.
• Launch Streaming Apps: Instantly open popular streaming services like Netflix, Amazon Prime Video, YouTube, and more, even on specific device models.
• Check TV Status: Get real-time information about your TV's current state, including the active channel or application.
• Automate TV Interactions: Integrate TV control into broader automation routines, such as "goodnight" scenes that turn off the TV.

Example Prompts

• "Turn off my Samsung TV."
• "Launch Netflix on the living room TV."
• "What's currently playing on my TV?"

Tips & Limitations

• App ID Specificity: App IDs for launching applications are often device-specific. The skill includes a mechanism to discover these IDs by first manually launching the app on the TV and then querying its status. Always confirm the appId from the TV's status payload rather than guessing.
• SmartThings CLI: While the skill automates much of the OAuth app creation, you may need the SmartThings CLI for initial device listing and troubleshooting. Ensure it's installed and configured if the automated setup requires manual intervention.
• OAuth Token Expiration: OAuth tokens expire. The skill is designed to refresh these tokens automatically, but manual re-authentication might be necessary in rare cases. Re-running the refresh command is usually sufficient.
• Network Connectivity: Both your AI agent and your Samsung TV must be connected to the same network for the skill to function correctly.