Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Readme
Python API to control heating 'smart boxes'
Install using pip from PyPI:
pip install smartbox
smartbox
Command Line ToolYou can use the smartbox
tool to get status information from your heaters
(nodes) and change settings.
A few common options are required for all commands:
-a
/--api-name
: The API name for your heater vendor. This is visible in
the 'API Host' entry in the 'Version' menu item in the mobile app/web app. If
the host name is of the form api-foo.xxxx
or api.xxxx
use the values
api-foo
or api
respectively.-u
/--username
: Your username as used for the mobile app/web app.-p
/--password
: Your password as used for the mobile app/web app.-b
/--base-auth-creds
: An HTTP Basic Auth credential used to do initial
authentication with the server. Use the base64 encoded string directly. See
'Basic Auth Credential' section below for more details.Verbose logging can be enabled with the -v
/--verbose
flag.
smartbox <auth options...> devices
The nodes
command lists nodes across all devices.
smartbox <auth options...> nodes
The status
command lists status across all nodes and devices.
smartbox <auth options...> status
The set-status
command can be used to change a status item on a particular
node.
smartbox <auth options...> set-status <-d/--device-id> <device id> <-n/--node-addr> <node> <name>=<value> [<name>=<value> ...]
The setup
command lists setup across all nodes and devices.
smartbox <auth options...> setup
The set-setup
command can be used to change a setup item on a particular
node.
smartbox <auth options...> set-setup <-d/--device-id> <device id> <-n/--node-addr> <node> <name>=<value> [<name>=<value> ...]
The device-away-status
command lists the away status across all devices.
smartbox <auth options...> device-away-status
The set-device-away-status
command can be used to change the away status on a
particular device.
smartbox <auth options...> set-device-away-status <-d/--device-id> <device id> <name>=<value> [<name>=<value> ...]
The device-power-limit
command lists the power limit (in watts) across all
devices.
smartbox <auth options...> device-power-limit
The set-device-power-limit
command can be used to change the power limit (in
watts) on a particular device.
smartbox <auth options...> set-device-power-limit <-d/--device-id> <device id> <limit>
Initial authentication to the smartbox REST API is protected by HTTP Basic Auth, in addition to the user's username and password which are then used to obtain an access token. In order not to undermine the security layer it provides, and also because it might change over time or vary between implementations, the token is not provided here and system owners need to find it themselves.
See api-notes.md for notes on REST and socket.io endpoints.
FAQs
Python API to control heating 'smart boxes'
We found that smartbox demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.