lifx-emulator 2.4.0

LIFX Emulator for testing LIFX LAN protocol libraries

LIFX Emulator

A comprehensive LIFX device emulator for testing LIFX LAN protocol libraries

Overview

LIFX Emulator implements the complete binary UDP protocol from lan.developer.lifx.com by providing virtual LIFX devices for testing without physical hardware. The emulator includes a basic web interface and OpenAPI-compliant REST API for device and scenario management at runtime.

Features

• Complete Protocol Support: 44+ packet types from the LIFX LAN protocol
• Multiple Device Types: Color lights, infrared, HEV, multizone strips, matrix tiles
• REST API and Web Interface: Monitor and manage your virtual devices during testing
• Testing Scenarios: Built-in support for packet loss, delays, malformed responses
• Easy Integration: Simple Python API and comprehensive CLI

Documentation

• Installation Guide - Get started
• Quick Start - Your first emulated device
• User Guide - Product specifications and testing scenarios
• Advanced Topics - REST API and persistent storage
• CLI Reference - All CLI options
• Device Types - Supported devices
• API Reference - Complete API docs
• Architecture - How it works

Use Cases

• Library Testing: Test your LIFX library without physical devices
• CI/CD Integration: Run automated tests in pipelines
• Protocol Development: Experiment with LIFX protocol features
• Error Simulation: Test error handling with configurable scenarios
• Performance Testing: Test concurrent device handling

Development

# Clone repository
git clone https://github.com/Djelibeybi/lifx-emulator.git
cd lifx-emulator

# Install with uv (recommended)
uv sync

# Or with pip
pip install -e ".[dev]"

# Run tests
uv run pytest

# Run linter
uv run ruff check .

# Build docs
uv run mkdocs serve

License

UPL-1.0

Links

• Documentation: https://djelibeybi.github.io/lifx-emulator
• GitHub: https://github.com/Djelibeybi/lifx-emulator
• PyPI: https://pypi.org/project/lifx-emulator/
• LIFX Protocol: https://lan.developer.lifx.com