{ "info": { "author": "Aaron Fleming", "author_email": "e_z_a@hotmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Programming Language :: Python :: 3" ], "description": "# Raspberry Pi Sense HAT display utility library\n\nFun toys for the Sense HAT LED display. Works well with Home Assistant.\n\nThis code is not yet ready for public consumption, but it shouldn't do any damage.\n\n## Currently implemented\n\n### `print`\n\nPrint some text set with `--message` on the tiny 8x8 pixel display.\n\nNot much good on its own, but is called by the next command.\n\n### `scroll`\n\nA classic scrolling text effect. Reads from stdin by default. Use the `--message` option to pass text from the command-line instead.\n\nThe default font has lots of accented characters, but you can use a different font with the `--font` option.\nBoth .ttf and .pil fonts are supported.\n\nIf you use a TrueType font then you might need to play with the `--font_size` option to make it readable.\n\nInvert the display with `--invert true` or set foreground and background colours with `-c` and `-bg`. These can be named or \"#rrggbb\" hex colours.\n\nUse `--repeat -1` to scroll forever.\nUse `--autorestore true` to restore whatever was on the screen before when done scrolling.\n\n### `pulse`\n\nPulse a colour (`-c`) out and in. Best used with the `--speed` and `--repeat` options.\n\n### `show_clock`\n\nShow a tiny analogue clock.\n\nUse `--repeat -1` to use your Sense HAT as an inaccurate timekeeper.\n\n### `fade_out`\n\nFade to black. Or, rather, fade to 47, which is the same thing.\n\n### `show_icon`\n\nIcons coming soon.\n\n\n## Getting started\n\nYou'll need a Raspberry Pi and Sense HAT first.\n\n### Prerequisites\n\nChange to the directory you downloaded this to.\n\nInstall requirements:\n```\npip install -r requirements.txt\n```\n\n### Running\n\nMake sure it's all working:\n```\npython main.py scroll --message \"Hello from the Raspberry Pi Sense HAT utility library!\"\n```\n\nYou should see the message scroll across your Sense HAT LEDs.\n\nIf it's upside down, then use the `--rotation` option (it's set to 180 by default).\n\n## Using with Home Assistant\n\nThis works rather nicely combined with Home Assistant's notify module using its command-line platform.\n\n### Prerequisites\n\nPrepare Home Assistant:\n\n* Add a new line to the end of `configuration.yaml`:\n```\necho 'notify: !include notify.yaml' >> configuration.yaml\n```\n\n* Create `notify.yaml` and set up various notification entities:\n```\n- name: good\n platform: command_line\n command: /srv/homeassistant/bin/python /home/homeassistant/SenseHatUtilities/main.py -c green scroll\n- name: bad\n platform: command_line\n command: /srv/homeassistant/bin/python /home/homeassistant/SenseHatUtilities/main.py -c red scroll\n- name: warning\n platform: command_line\n command: /srv/homeassistant/bin/python /home/homeassistant/SenseHatUtilities/main.py -c yellow scroll\n- name: info\n platform: command_line\n command: /srv/homeassistant/bin/python /home/homeassistant/SenseHatUtilities/main.py -c cyan scroll\n```\n\n* Restart Home Assistant\n\n### Test it\n\n* Go to Services, under Developer Tools\n* Select the `notify.good` service\n* In the Service Data field, enter `{\"message\":\"Home Assistant is talking to you via SenseHatUtilities!\"}`\n* Click the Call Service button and watch your Sense HAT.\n\n### Use it in your automations\n\n* Send the current temperature\n\n### Go further\n\nYou can chain calls easily with a shell script.\n\nMake sure important messages aren't missed: try using the `pulse` action to flash the LEDs a few times before using `scroll_repeat` to repeat the message a few times.\n\n\n## Acknowledgements\n\n* Pi and Sense HAT creators\n* Home Assistant creators\n* Miniwi font creator\n\n[Docs](http://sense-hat-display-utilities.readthedocs.io/en/latest/)\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/e2m4n/python-sense-hat-display-utils", "keywords": "sense-hat", "license": "", "maintainer": "", "maintainer_email": "", "name": "sense-hat-display-utils", "package_url": "https://pypi.org/project/sense-hat-display-utils/", "platform": "", "project_url": "https://pypi.org/project/sense-hat-display-utils/", "project_urls": { "Homepage": "https://github.com/e2m4n/python-sense-hat-display-utils" }, "release_url": "https://pypi.org/project/sense-hat-display-utils/0.1.6/", "requires_dist": [ "sense-hat", "Pillow", "colour" ], "requires_python": "", "summary": "Utilities for the LED display on the Raspberry Pi Sense HAT", "version": "0.1.6" }, "last_serial": 3405328, "releases": { "0.1.6": [ { "comment_text": "", "digests": { "md5": "add660aad158fbc8b11e5523840ea73a", "sha256": "13c38f12413c2d9c8683bae08d54641868cb2dc0e396dfeadb29fbece1b40d39" }, "downloads": -1, "filename": "sense_hat_display_utils-0.1.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "add660aad158fbc8b11e5523840ea73a", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 14471, "upload_time": "2017-12-10T12:49:23", "url": "https://files.pythonhosted.org/packages/05/39/7c09005f4ed12688f5cf1ebba11706c3e451934fc1a1f619a7327daa360d/sense_hat_display_utils-0.1.6-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ab2510414858f786590e1242a60d97de", "sha256": "fefba0c5004d676a02d7874b6378c769dcde3c661e2030a4ea656e19472c9855" }, "downloads": -1, "filename": "sense_hat_display_utils-0.1.6.tar.gz", "has_sig": false, "md5_digest": "ab2510414858f786590e1242a60d97de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10419, "upload_time": "2017-12-10T12:49:25", "url": "https://files.pythonhosted.org/packages/2d/9a/1a42c7c1173172f0f5f334b1e0ba93ae340b44103b8f52c663f7f2658c38/sense_hat_display_utils-0.1.6.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "add660aad158fbc8b11e5523840ea73a", "sha256": "13c38f12413c2d9c8683bae08d54641868cb2dc0e396dfeadb29fbece1b40d39" }, "downloads": -1, "filename": "sense_hat_display_utils-0.1.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "add660aad158fbc8b11e5523840ea73a", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 14471, "upload_time": "2017-12-10T12:49:23", "url": "https://files.pythonhosted.org/packages/05/39/7c09005f4ed12688f5cf1ebba11706c3e451934fc1a1f619a7327daa360d/sense_hat_display_utils-0.1.6-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ab2510414858f786590e1242a60d97de", "sha256": "fefba0c5004d676a02d7874b6378c769dcde3c661e2030a4ea656e19472c9855" }, "downloads": -1, "filename": "sense_hat_display_utils-0.1.6.tar.gz", "has_sig": false, "md5_digest": "ab2510414858f786590e1242a60d97de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10419, "upload_time": "2017-12-10T12:49:25", "url": "https://files.pythonhosted.org/packages/2d/9a/1a42c7c1173172f0f5f334b1e0ba93ae340b44103b8f52c663f7f2658c38/sense_hat_display_utils-0.1.6.tar.gz" } ] }