A Fibaro Home Center 3 QuickApp for controlling Samsung SmartThings compatible air conditioning units. This app provides seamless integration between your Fibaro smart home system and SmartThings AC devices.
This is an unofficial, third-party implementation and is not affiliated with, endorsed by, or supported by Samsung SmartThings or Fibaro. This project is developed independently by the community for educational and personal use.
- Auto-Discovery: Automatically discovers and adds SmartThings AC devices
- Cooling Mode Control: Thermostat functionality with cooling mode support (other modes are not supported)
- Fan Control: Multiple fan speed settings (Auto, Low, Medium, High, Turbo)
- Optional Modes: Support for WindFree and Speed modes
- Automatic Status Updates: Periodic polling and status updates (default: 60-second intervals)
- OAuth2 Authentication: Secure token-based authentication with auto-refresh
- Download the
SmartThings.fqafile from this repository - Import the .fqa file into your Fibaro Home Center 3
- Configure the QuickApp variables (see Configuration section)
SmartThings Personal Access Tokens (PATs) created after December 30, 2024 are only valid for 24 hours. For continuous access, SmartThings recommends using OAuth2 authorization code flow instead.
Install SmartThings CLI:
- macOS:
brew install smartthingscommunity/smartthings/smartthings - Windows: Download
smartthings.msifrom GitHub releases - Linux: Download and extract the appropriate binary
Create the app:
smartthings apps:createConfiguration:
- Scopes:
r:devices:*,x:devices:* - Redirect URI:
https://my.local/callback
Save the OAuth credentials:
OAuth Client Id: 3f8b4e2a-9c6d-4f7e-8a1b-5c3d9e7f2a8b
OAuth Client Secret: 7k9m2n4p-6q8r-1s3t-5u7v-9w1x3y5z7a9b
For more details see: SmartThings API: Taming the OAuth 2.0 Beast
Install Node.js:
- Windows: Download installer from nodejs.org and run the .msi file
- macOS:
brew install nodeor download installer from nodejs.org - Linux:
- Ubuntu/Debian:
sudo apt install nodejs npm - CentOS/RHEL:
sudo yum install nodejs npm - Or download from nodejs.org
- Ubuntu/Debian:
Verify installation:
node --versionRun the token generator:
node get-token.jsThe script will:
- Ask for your OAuth Client ID and Client Secret (from Step 1)
- Generate and display the authorization URL
- Wait for authorization code from the callback URL
- Exchange the code for tokens
- Output all required QuickApp variables
Token Information:
- Access Token: Valid for 24 hours
- Refresh Token: Valid for 30 days, can be renewed
- Auto-refresh: The QuickApp automatically refreshes tokens before expiry
Set the following variables in your QuickApp:
| Variable | Description | Required |
|---|---|---|
clientId |
SmartThings API Client ID | Yes |
clientSecret |
SmartThings API Client Secret | Yes |
refreshToken |
OAuth2 Refresh Token | Yes |
Each AC device can be configured with the following optional variables:
| Variable | Description | Default |
|---|---|---|
pollInterval |
Status polling interval (seconds) | 60 |
SmartThings API Rate Limits:
According to the SmartThings API documentation, device APIs have a rate limit of 12 requests per minute per device. This applies to:
- Get device state requests
- Send device commands
- Create state events
Recommended Polling Intervals:
- Minimum recommended: 10 seconds (6 polling requests/minute)
- Default setting: 60 seconds (1 polling request/minute, optimal for most use cases)
- Off: Turns off the AC unit
- Cool: Activates cooling mode with auto fan
- Auto: Automatic fan speed
- Low/Medium/High/Turbo: Manual fan speed control
- WindFree: Samsung's wind-free cooling technology
- Speed: High-speed cooling mode
- Use the standard Fibaro thermostat interface
- Set cooling setpoint between 16°C - 30°C
- 1°C increments supported
- Fork the repository
- Create your feature branch
- Test thoroughly with real devices
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
This project is provided as-is for educational and personal use.