{"id":15450804,"url":"https://github.com/whizzzkid/rpi-ws281x-matrix-python","last_synced_at":"2025-04-28T18:10:16.639Z","repository":{"id":147369221,"uuid":"201531625","full_name":"whizzzkid/rpi-ws281x-matrix-python","owner":"whizzzkid","description":"WS281x LED Matrix Image Rendering Library","archived":false,"fork":false,"pushed_at":"2019-08-12T05:05:54.000Z","size":230,"stargazers_count":17,"open_issues_count":5,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-26T03:14:53.701Z","etag":null,"topics":["image","led","ledmatrix","raspberry-pi","raspberry-pi-3","raspberry-pi-gpio","ws2811","ws2812","ws2812b","ws281x"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whizzzkid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-09T19:51:45.000Z","updated_at":"2024-03-23T12:54:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"c8a72230-11b0-48aa-be8b-cd52c729057a","html_url":"https://github.com/whizzzkid/rpi-ws281x-matrix-python","commit_stats":{"total_commits":14,"total_committers":2,"mean_commits":7.0,"dds":0.0714285714285714,"last_synced_commit":"414d2e16fdd37686e0272de4f23008b1976d9e1c"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whizzzkid%2Frpi-ws281x-matrix-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whizzzkid%2Frpi-ws281x-matrix-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whizzzkid%2Frpi-ws281x-matrix-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whizzzkid%2Frpi-ws281x-matrix-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whizzzkid","download_url":"https://codeload.github.com/whizzzkid/rpi-ws281x-matrix-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251362153,"owners_count":21577403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image","led","ledmatrix","raspberry-pi","raspberry-pi-3","raspberry-pi-gpio","ws2811","ws2812","ws2812b","ws281x"],"created_at":"2024-10-01T21:19:58.444Z","updated_at":"2025-04-28T18:10:16.611Z","avatar_url":"https://github.com/whizzzkid.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WS281X NeoPixel-ish Matrix Rendering Library\n\nThis library is intended to make the neopixel ish LED matrix to work with raspberry pi and Python. It is based on this [rpi-ws281x](https://github.com/rpi-ws281x/rpi-ws281x-python) python implementation. This makes it setting up your LED panel faster and removes a lot of hiccups. The original library does not work with panel, it is meant to control the strip.\n\n## Features offered\n\n* Direct resizing and rendering of images (png/jpeg).\n* Direct resizing and rendering of animations (gif)\n* Frames are represented as RGB Tuples so building your own frame is very simple.\n* Excellent brightness control.\n* Support for multi panel configurations.\n* Non-blocking threads, the operations are async and will not block you.\n\n## Setup\n\nYou'll need to install pillow and rpi-ws281x packages (and their dependencies from pip)\n```\n# pip install pillow rpi-ws281x\n```\n\n## Demo\n\n```\n# python demo.py\n```\n\nThe order is red -\u003e green -\u003e blue -\u003e image -\u003e animation. If this is not the order you see, your strip config is different than the mine.\n\n## Adding to your project\n\nAdd it as a submodule.\n\n```\n$ git submodule add https://github.com/whizzzkid/rpi-ws281x-matrix-python matrix\n```\nIn your project\n```\nfrom matrix.ws281xMatrix import WS281xMatrix\n\nscreen = WS281xMatrix()\n```\n\n## API\n\nOnce you have:\n```\nscreen = WS281xMatrix()\n```\n\nYou can simply ask it to render an image like so:\n```\nscreen.render_image('path_to_image')\n```\n\n## Why is this needed?\nWhen I wrote this, I was frustrated to make [this 16x16 panel](https://amzn.to/2H10an3) work with RPi. The Adafruit Neopixel library claims that their panels cannot work with RPi because of their strict timing requirements. However that is not the case. The rpi-281x library is a proof that it works, however it does not allow you to dump images/animations directly on the screen. This library aims to solve just that.\n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhizzzkid%2Frpi-ws281x-matrix-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhizzzkid%2Frpi-ws281x-matrix-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhizzzkid%2Frpi-ws281x-matrix-python/lists"}