Skip to main content

Python API for the Luxafor Flag

Project description

===============================
PyLuxafor
===============================


.. image:: https://img.shields.io/pypi/v/pyluxafor.svg
:target: https://pypi.python.org/pypi/pyluxafor
:remote:

.. image:: https://img.shields.io/travis/takeontom/pyluxafor.svg
:target: https://travis-ci.org/takeontom/pyluxafor
:remote:

.. image:: https://readthedocs.org/projects/pyluxafor/badge/?version=latest
:target: https://pyluxafor.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
:remote:

.. image:: https://pyup.io/repos/github/takeontom/pyluxafor/shield.svg
:target: https://pyup.io/repos/github/takeontom/pyluxafor/
:alt: Updates
:remote:


Python API for the Luxafor Flag


* Free software: MIT license
* Documentation: https://pyluxafor.readthedocs.io.


Features
--------

* Python 3+
* Simple, clean API to control the
`Luxafor Flag <http://luxafor.com/luxafor-flag/>`
* Where possible, allows the setting of multiple, specific LEDs at once.


Installation
------------

Install via pip::

$ pip install pyluxafor

Create the file: `/etc/udev/rules.d/10-luxafor.rules` with the following
contents::

ACTION=="add", SUBSYSTEM=="usb", ATTRS{idProduct}=="f372", ATTRS{idVendor}=="04d8", MODE:="666"

Then reload udev::

$ sudo service udev reload

Then unplug your Luxafor Flag and reinsert it.

Example usage
-------------

::

from pyluxafor import LuxaforFlag
from time import sleep

flag = LuxaforFlag()
flag.off()
flag.do_fade_colour(
leds=[LuxaforFlag.LED_TAB_1, LuxaforFlag.LED_BACK_1, LuxaforFlag.LED_BACK_2],
r=10, g=10, b=0,
duration=255
)
flag.do_static_colour(leds=LuxaforFlag.LED_BACK_3, r=0, g=0, b=100)

sleep(3)
flag.off()

flag.do_pattern(LuxaforFlag.PATTERN_POLICE, 3)


Credits
---------

Many thanks to `vmitchell85 <https://github.com/vmitchell85>` for his
`luxafor-python <https://github.com/vmitchell85/luxafor-python>` project,
which provided the initial inspiration for this project, and provided easy
answers to the problems I encountered.

If you're looking to control a Luxafor Flag in Windows using Python,
vmitchell85's project is probably the best bet:

* https://github.com/vmitchell85/luxafor-python


=======
History
=======

0.1.0 (2016-12-13)
------------------

* First release on PyPI.

Project details


Download files

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

Files for pyluxafor, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pyluxafor-0.2.0-py2.py3-none-any.whl (6.0 kB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size pyluxafor-0.2.0.tar.gz (23.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page