v1.0.2

govee-python v1.0.2

Release date: February 23, 2025

Installation

pip install govee-python==1.0.2
# or upgrade
pip install --upgrade govee-python

PyPI: https://pypi.org/project/govee-python/1.0.2/

---

What's New

Added

• Comprehensive Color Palettes – 90+ predefined RGB color constants

  • Basic, neon, pastel, warm whites, seasonal (Halloween, Christmas, patriotic), deep/dark, and nature palettes
  • Colors.list_colors() and improved Colors.get() documentation

• Optional LAN Verification – New verify parameter on GoveeClient.power()

  • Use client.power(device, False, verify=False) for faster fire-and-forget power commands when confirmation isn’t needed

Changed

• Aggressive LAN Timeouts – LAN timeouts reduced from 2–10 seconds to 0.5 seconds

  • Much faster Cloud API fallback when LAN is unavailable
  • Verification: 500ms delay + 500ms status query (1 second max)

• Faster State Restoration – State restore now uses verify=False for power commands

  • Post-show restore in ~1 second instead of 10+ seconds

Fixed

• LAN Status Socket Conflicts – Resolved "[Errno 48] Address already in use" during parallel status queries
  • LAN status queries now use ephemeral ports so multiple queries can run without port conflicts

---

Links

• Changelog
• Repository

v1.0.1

Version 1.0.1 - Patch Release

This patch release follows a complete git history rewrite and codebase cleanup, ensuring a clean foundation for future development.

What's Changed

• Git History Rewrite - Clean slate with a single initial commit
• Codebase Cleanup - Removed legacy code and improved structure
• Documentation Updates - Updated repository URLs and metadata
• PyPI Synchronization - Aligned with PyPI package version

Installation

pip install govee-python==1.0.1

Features

• Interactive CLI Wizard - Easy setup and device control with govee-sync
• Dual Protocol Support - LAN (UDP) for fast local control, Cloud API for full features
• Automatic Fallback - Tries LAN first, falls back to Cloud seamlessly
• State Management - Save and restore device states (perfect for light shows)
• Type-Safe Models - Full type hints with dataclasses for IDE autocomplete
• Python Module Export - Import devices and scenes directly as Python objects
• Built-in & DIY Scenes - Apply Govee's default scenes or your custom creations
• Concurrent Operations - Control multiple devices simultaneously
• Batch Operations - Group devices for coordinated control

Quick Start

govee-sync

The wizard will guide you through setting up your API key, discovering devices, and exporting Python modules.

Documentation

See README.md for full documentation and examples.

v1.0.0

Version 1.0.0 - Initial Release

A modern, easy-to-use Python library for controlling Govee smart lights via LAN (UDP) and Cloud (HTTPS) APIs.

Features

• Interactive CLI Wizard - Easy setup and device control with govee-sync
• Dual Protocol Support - LAN (UDP) for fast local control, Cloud API for full features
• Automatic Fallback - Tries LAN first, falls back to Cloud seamlessly
• State Management - Save and restore device states (perfect for light shows)
• Type-Safe Models - Full type hints with dataclasses for IDE autocomplete
• Python Module Export - Import devices and scenes directly as Python objects
• Built-in & DIY Scenes - Apply Govee's default scenes or your custom creations
• Concurrent Operations - Control multiple devices simultaneously
• Batch Operations - Group devices for coordinated control

Installation

pip install govee-python

Quick Start

govee-sync

The wizard will guide you through setting up your API key, discovering devices, and exporting Python modules.

Documentation

See README.md for full documentation and examples.