https://github.com/rrooggiieerr/homeassistant-okokscale
Home Assistant integration for OKOK Scales
https://github.com/rrooggiieerr/homeassistant-okokscale
bluetooth homeassistant homeassistant-custom-component homeassistant-integration homeautomation python python3 scale
Last synced: 3 months ago
JSON representation
Home Assistant integration for OKOK Scales
- Host: GitHub
- URL: https://github.com/rrooggiieerr/homeassistant-okokscale
- Owner: rrooggiieerr
- License: apache-2.0
- Created: 2023-02-12T20:56:32.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-10T05:52:49.000Z (5 months ago)
- Last Synced: 2025-01-10T06:48:48.790Z (5 months ago)
- Topics: bluetooth, homeassistant, homeassistant-custom-component, homeassistant-integration, homeautomation, python, python3, scale
- Language: Python
- Homepage:
- Size: 87.9 KB
- Stars: 13
- Watchers: 4
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Home Assistant integration for OKOK Scales
![Python][python-shield]
[![GitHub Release][releases-shield]][releases]
[![Licence][license-shield]][license]
[![Maintainer][maintainer-shield]][maintainer]
[![Home Assistant][homeassistant-shield]][homeassistant]
[![HACS][hacs-shield]][hacs]
[![Github Sponsors][github-shield]][github]
[![PayPal][paypal-shield]][paypal]
[![BuyMeCoffee][buymecoffee-shield]][buymecoffee]
[![Patreon][patreon-shield]][patreon]
## Introduction
Home Assistant integration to read Bluetooth scales which can be used with the *OKOK international*
app and identify themselves on Bluetooth as *Chipsea-BLE*.
## Features
- Installation/Configuration through auto detection
- Read weight and battery status
## Hardware
## Supported scales
The following scale is known to work:
* Tristar WG-2440
Please let me know if your scale works with this Home Assistant integration so I can
improve the overview of supported scales.
## Installation
### HACS
The recommended way to install this Home Assistant integration is by using [HACS][hacs].
Click the following button to open the integration directly on the HACS integration page.
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=rrooggiieerr&repository=homeassistant-okokscale&category=integration)
Or follow these instructions:
- Go to your **HACS** view in Home Assistant and then to **Integrations**
- Open the **Custom repositories** menu
- Add this repository URL to the **Custom repositories** and select
**Integration** as the **Category**
- Click **Add**
- Close the **Custom repositories** menu
- Select **+ Explore & download repositories** and search for *OKOK Scale*
- Select **Download**
- Restart Home Assistant
### Manually
- Copy the `custom_components/okokscale` directory of this repository into the
`config/custom_components/` directory of your Home Assistant installation
- Restart Home Assistant
## Adding a new OKOK Scale
New OKOK Scale devices will automatically be detected after the integration has been installed and
Home Assistant is restarted. If your scale is not detected it's not supported by this integration.
## Contribute your language
If you would like to use this Home Assistant integration in your own language you can provide a
translation file as found in the `custom_components/okokscale/translations` directory. Create a
pull request (preferred) or issue with the file attached.
More on translating custom integrations can be found
[here](https://developers.home-assistant.io/docs/internationalization/custom_integration/).
## Star this repository
Help other Home Assistant users find this integration by starring this repository. Click **⭐ Star**
on the top right of the GitHub page.
## Support my work
Do you enjoy using this Home Assistant integration? Then consider supporting my work using one of
the following platforms, your donation is greatly appreciated and keeps me motivated:
[![Github Sponsors][github-shield]][github]
[![PayPal][paypal-shield]][paypal]
[![BuyMeCoffee][buymecoffee-shield]][buymecoffee]
[![Patreon][patreon-shield]][patreon]
## Hire me
If you would like to have a Home Assistant integration developed for your product or are in need
for a freelance Python developer for your project please contact me, you can find my email address
on [my GitHub profile](https://github.com/rrooggiieerr).
[python-shield]: https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54
[releases]: https://github.com/rrooggiieerr/homeassistant-okokscale/releases
[releases-shield]: https://img.shields.io/github/v/release/rrooggiieerr/homeassistant-okokscale?style=for-the-badge
[license]: ./LICENSE
[license-shield]: https://img.shields.io/github/license/rrooggiieerr/homeassistant-okokscale?style=for-the-badge
[maintainer]: https://github.com/rrooggiieerr
[maintainer-shield]: https://img.shields.io/badge/MAINTAINER-%40rrooggiieerr-41BDF5?style=for-the-badge
[homeassistant]: https://www.home-assistant.io/
[homeassistant-shield]: https://img.shields.io/badge/home%20assistant-%2341BDF5.svg?style=for-the-badge&logo=home-assistant&logoColor=white
[hacs]: https://hacs.xyz/
[hacs-shield]: https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=for-the-badge
[paypal]: https://paypal.me/seekingtheedge
[paypal-shield]: https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white
[buymecoffee]: https://www.buymeacoffee.com/rrooggiieerr
[buymecoffee-shield]: https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black
[github]: https://github.com/sponsors/rrooggiieerr
[github-shield]: https://img.shields.io/badge/sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=#EA4AAA
[patreon]: https://www.patreon.com/seekingtheedge/creators
[patreon-shield]: https://img.shields.io/badge/Patreon-F96854?style=for-the-badge&logo=patreon&logoColor=white