Installations

npm install homebridge-ambiclimate-platform

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=14.18.1

Node Version

16.15.1

NPM Version

8.11.0 Pull Requests

Open

1

Total

2

Closed

0

Merged

1

Issues

Open

1

Total

14

Closed

13

Releases

Unable to fetch releases

Contributors

2

Unable to fetch Contributors

View all 2 contributors

Languages

1

TypeScript

TypeScript (100%)

Developer

hirakujira

Download Statistics

Total Downloads

2,967

Last Day

7

Last Week

14

Last Month

44

Last Year

320

GitHub Statistics

5 Stars

31 Commits

2 Forks

4 Watching

1 Branches

2 Contributors

Maintainers

1

Package Meta Information

Latest Version

1.2.0

Package Id

homebridge-ambiclimate-platform@1.2.0

Unpacked Size

147.96 kB

Size

23.62 kB

File Count

32

NPM Version

8.11.0

Node Version

16.15.1

Total Downloads

Cumulative downloads

Total Downloads

2,967

Last day

0%

7

Compared to previous day

Last week

27.3%

14

Compared to previous week

Last month

144.4%

44

Compared to previous month

Last year

-27.8%

320

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

2

axios node-ambiclimate

Dev Dependencies

9

@types/node @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint homebridge nodemon rimraf ts-node typescript

Versions

Homebridge Ambi Climate Platform

Inspired by homebridge-ambiclimate. This plugin supports these features for Ambi Climate devices:

Show current temperature
Show current relative humidity
Show current fan state (High, Med, Low as percentage of rotation speed)
Turn on and off - for comfortable mode
Comfortable mode feedbacks

Installation

After Homebridge has been installed:

sudo npm i -g homebridge-ambiclimate-platform@latest

You need to register an OAuth client in the Ambi Dev Portal by following the steps on the Quick Start page. Client ID and client Secret of that OAuth client are required, in order to use this plugin.

Config

Simple config example:

{
    "bridge": {
    ...
    },
    "accessories": [
    ...
    ],
    "platforms": [{
        "platform": "AmbiClimatePlatform",
        "clientId": "00000000-1111-2222-3333-444444444444",
        "clientSecret": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "username": "example@gmail.com",
        "password": "password_here",
        "showFeedbacks": true,
        "accessories": [{
            "roomName": "Living Room",
            "locationName": "Taipei"
        }]
    }
    ]
}

Options

Attributes	Required	Usage	Default	Options
clientId	YES	OAuth client Id
clientSecret	YES	OAuth client secret
username	YES	Your Ambi Climate account username
password	YES	Your Ambi Climate account password
showFeedbacks		Show feedback options as switches. (Too Hot, Too Warm, Bit Warm, Comfortable, Bit Cold, Too Cold and Freezing)	false	true/false
heaterCoolerMode		Add device as heater cooler (air condition). Notice: This would set Ambi Climate to temperature mode instead of comfort mode. Also, due to limitations of Ambi Climate APIs (which doesn't allow set to heat/cool mode manually), the status it shows may be different from your settings.	false	true/false
accessories.roomName	YES	Device room name, must match the name within the Ambi Climate App
accessories.locationName	YES	Device location name, must match the name within the Ambi Climate App

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.5

/10

Last Scanned on 2025-01-27

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More