lifx-emulator

Standalone LIFX device emulator with CLI and HTTP management API.

This package provides a ready-to-run emulator for testing LIFX LAN protocol libraries. It includes a command-line interface and an optional HTTP API for runtime device management.

Installation

pip install lifx-emulator

Quick Start

# Start with default configuration (1 color light)
lifx-emulator

# Create multiple device types
lifx-emulator --color 2 --multizone 1 --tile 1

# Enable HTTP management API
lifx-emulator --api

# List available LIFX products
lifx-emulator list-products

# Create devices by product ID
lifx-emulator --product 27 --product 38 --product 55

Features

Command-line interface for quick emulator setup
HTTP management API with web dashboard
Real-time device monitoring and management
Support for all LIFX device types (color, multizone, tile, infrared, HEV, switch)
Persistent device state across restarts
Testing scenarios for protocol edge cases

HTTP Management API

Enable with --api to get:

Web Dashboard: http://localhost:8080 - Real-time monitoring UI
REST API: Device management, statistics, and scenario control
OpenAPI Docs: http://localhost:8080/docs - Interactive API documentation

# Start with API server
lifx-emulator --color 2 --api --api-port 9090

# Add a device via API
curl -X POST http://localhost:9090/api/devices \
  -H "Content-Type: application/json" \
  -d '{"product_id": 27}'

Documentation

Full documentation is available at: https://djelibeybi.github.io/lifx-emulator

Related Packages

lifx-emulator-core: Core library for embedding the emulator in your own projects

License

UPL-1.0

Environment
- Console
Framework
- AsyncIO
- FastAPI
- Pytest
Intended Audience
- Developers
Natural Language
- English
Operating System
- OS Independent
Programming Language
Topic
- Software Development :: Testing
Typing
- Typed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lifx_emulator-4.5.1.tar.gz (156.6 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

lifx_emulator-4.5.1-py3-none-any.whl (97.5 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file lifx_emulator-4.5.1.tar.gz.

File metadata

Download URL: lifx_emulator-4.5.1.tar.gz
Upload date: Aug 11, 2026
Size: 156.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lifx_emulator-4.5.1.tar.gz
Algorithm	Hash digest
SHA256	`31d33cb87d0533b9c53c60f5d01c9758cef7ec84cb27ec7410e522a35d475727`
MD5	`413a19b54959fa5fa6394c9f1d58f5f4`
BLAKE2b-256	`3c8eee44781503e213e82424528dfd6c2d171945b4e0175053efe41d2a7f98d6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for lifx_emulator-4.5.1.tar.gz:

Publisher: ci.yml on Djelibeybi/lifx-emulator

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: lifx_emulator-4.5.1.tar.gz
- Subject digest: 31d33cb87d0533b9c53c60f5d01c9758cef7ec84cb27ec7410e522a35d475727
- Sigstore transparency entry: 2416128994
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: Djelibeybi/lifx-emulator@4096a23d42d74e34e5bc11b07575cb9517c5920e
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Djelibeybi
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@4096a23d42d74e34e5bc11b07575cb9517c5920e
- Trigger Event: push