Skip to main content

PySnooz

Python Language + Bleak API + SNOOZ White Noise Machine

CI Status Test coverage percentage PyPI Version

Control SNOOZ white noise machines with Bluetooth.

Installation

Install this via pip (or your favourite package manager):

pip install pysnooz

Supported devices

Usage

import asyncio
from datetime import timedelta
from home_assistant_bluetooth import BluetoothServiceInfo
from pysnooz.device import (
  SnoozAdvertisementData,
  SnoozDevice,
  SnoozCommandResultStatus,
  disable_night_mode,
  enable_night_mode,
  get_device_info,
  set_auto_temp_enabled,
  set_fan_speed,
  set_light_brightness,
  set_temp_target,
  set_volume,
  turn_fan_off,
  turn_fan_on,
  turn_light_off,
  turn_light_on,
  turn_off,
  turn_on,
)

# found with discovery
device_info = BluetoothServiceInfo(...)
advertisement = parse_snooz_advertisement(device_info)

device = SnoozDevice(device_info, advertisement)

# optionally specify a volume to set before turning on
await device.async_execute_command(turn_on(volume=100))

# you can transition volume by specifying a duration
await device.async_execute_command(turn_off(duration=timedelta(seconds=10)))

other_commands = [
  set_volume(50, duration=timedelta(seconds=10)),
  set_light_brightness(75),
  turn_light_on(),
  turn_light_off(),
  enable_night_mode(),
  disable_night_mode(),

  # the following commands are only supported by Breez
  set_fan_speed(33, duration=timedelta(seconds=10)),
  set_auto_temp_enabled(True),
  set_temp_target(71)
]
for command in other_commands:
  await device.async_execute_command(command)

# view the result of a command execution
result = await device.async_execute_command(turn_on())
assert result.status == SnoozCommandResultStatus.SUCCESS
result.duration # how long the command took to complete

Contributors ✨

Thanks goes to these wonderful people (emoji key):

bradleysryder
bradleysryder

💻
Martin Weinelt
Martin Weinelt

💻
epenet
epenet

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Credits

This package was created with Cookiecutter and the browniebroke/cookiecutter-pypackage project template.

Metadata

Release files for pysnooz 0.10.1

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

Source distribution (sdist)

Source distribution for pysnooz 0.10.1
File Size Uploaded Provenance Actions
pysnooz-0.10.1.tar.gz 22.9 kB With provenance Details for pysnooz-0.10.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pysnooz 0.10.1
File Interpreter ABI Platform Actions
pysnooz-0.10.1-py3-none-any.whl Python 3 none any Details for pysnooz-0.10.1-py3-none-any.whl

Total release size: 48.3 kB

Release files / pysnooz-0.10.1.tar.gz

Download URL pysnooz-0.10.1.tar.gz
Size 22.9 kB
Tags Source
SHA-256 checksum
How to use checksums
08eb123288bc05fb350e71098ceb90b1ce220a16ec44ff7adae4a966b27e7d9c
BLAKE2b-256 checksum
How to use checksums
0368e3755640f9e694dde9b4e2769cd6501d8752c2f153b4c355b0f42902629f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / pysnooz-0.10.1-py3-none-any.whl

Download URL pysnooz-0.10.1-py3-none-any.whl
Size 25.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1c9431b7973f90ca3e8aaffb48af964311abeba3ec1ae39f355420ffe91d64ea
BLAKE2b-256 checksum
How to use checksums
18cdd9c03831dd326f18530ad2661307073f778413303244a1693c5ef39f82db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for pysnooz 0.10.1

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pysnooz-0.10.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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