Skip to main content

vitafit-ble

Bluetooth library for Vitafit smart scales.

Supported models:

  • Vitafit VT701 body fat scale

See supported devices for more details.

Unofficial; not affiliated with Vitafit.

Install

pip install vitafit-ble

Use

from bleak import BleakClient
from vitafit_ble import async_measure

async with BleakClient(address) as client:
    measurement = await async_measure(client)

It returns a Measurement with weight_kg (always kg), impedance_ohm and display_unit, or None if no stable weight arrives within 30 s. impedance_ohm is None if impedance isn't measured, for example through socks or if you step off early.

For options or callbacks, such as the live weight, use a VitafitSession. For example, the Vitafit app's "Weight Only Mode" skips impedance, and the scale keeps it for later offline weigh-ins:

from vitafit_ble import VitafitSession

measurement = await VitafitSession(weight_only=True).async_measure(client)

For Home Assistant, poll_needed() says when to connect, and async_poll() connects, runs a weigh-in and disconnects. See usage for details.

Acknowledgements

This library has been created with the assistance of Claude Code and Opus 5.5.

The protocol is based on openScale's VT701 handler.

Licence

MIT

Metadata

Release files for vitafit-ble 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vitafit-ble 0.4.0
File Size Uploaded Provenance
vitafit_ble-0.4.0.tar.gz 9.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for vitafit-ble 0.4.0
File Interpreter ABI Platform
vitafit_ble-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 19.9 kB

Release files / vitafit_ble-0.4.0.tar.gz

Download URL vitafit_ble-0.4.0.tar.gz
Size 9.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f3d82ae9cad968239efbff6340c2f0916dfaa02601a25e274526cba407982abd
BLAKE2b-256 checksum
How to use checksums
e4156bfb33476271da350fe4b605aae3f3ac5b9dc9dd774c2a2c2ae438714aa1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / vitafit_ble-0.4.0-py3-none-any.whl

Download URL vitafit_ble-0.4.0-py3-none-any.whl
Size 10.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
47cac5b39c57ce02e738a275bf34a52bd8c00e304fdaf187c2eee39a2104a81c
BLAKE2b-256 checksum
How to use checksums
245f9c935baddc549aae1e5f40e272bc4e48ceb4351cbf03ba1a1144cca8921e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for vitafit-ble 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page