{"id":18363415,"url":"https://github.com/stuttgart-things/homerun-matrix-catcher","last_synced_at":"2025-04-10T06:49:42.564Z","repository":{"id":260460879,"uuid":"881349446","full_name":"stuttgart-things/homerun-matrix-catcher","owner":"stuttgart-things","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-02T04:19:58.000Z","size":2646,"stargazers_count":0,"open_issues_count":12,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-02T05:23:22.899Z","etag":null,"topics":["homerun","led-matrix-panel","matrix","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stuttgart-things.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-10-31T11:57:05.000Z","updated_at":"2025-03-24T16:09:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"26a09c86-3b29-421e-942c-f495bf69df77","html_url":"https://github.com/stuttgart-things/homerun-matrix-catcher","commit_stats":null,"previous_names":["stuttgart-things/homerun-matrix-catcher"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuttgart-things%2Fhomerun-matrix-catcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuttgart-things%2Fhomerun-matrix-catcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuttgart-things%2Fhomerun-matrix-catcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuttgart-things%2Fhomerun-matrix-catcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stuttgart-things","download_url":"https://codeload.github.com/stuttgart-things/homerun-matrix-catcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248173850,"owners_count":21059595,"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":["homerun","led-matrix-panel","matrix","python"],"created_at":"2024-11-05T23:06:26.318Z","updated_at":"2025-04-10T06:49:42.536Z","avatar_url":"https://github.com/stuttgart-things.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Raspbian Setup:\n\nOS-Requirement:\n* Raspberry Pi OS (Legacy) Lite\n* Release date: October 22nd 2024\n* System: 32-bit\n* Kernel version: 6.1\n* Debian version: 11 (bullseye)\n\n(Python: Python3.9)\n\nDonwload iso-image [click here](https://downloads.raspberrypi.com/raspios_oldstable_lite_armhf/images/raspios_oldstable_lite_armhf-2024-10-28/2024-10-22-raspios-bullseye-armhf-lite.img.xz)\n\n\n## Activate SSH\n\n```bash\n# Use the arrow keys to navigate to Interface Options and press Enter.\n# Select SSH and press Enter.\n# You will be asked if you want to enable the SSH server. Select Yes and press Enter.\n# After enabling SSH, navigate to Finish and press Enter.\n# You may be prompted to reboot your Raspberry Pi. If so, select Yes to reboot.\nsudo raspi-config\n```\n\n## Virtual environment download, install and setup\n\n```bash\nsudo apt install python3-venv\npython3 -m venv .venv\n```\n\n```bash\n# Activate venv on login\necho -e \"\\n# Activate virtual environment on login\\nif [ -d \\\"/home/sthings/.venv\\\" ]; then\\n    source .venv/bin/activate\\nfi\" \u003e\u003e /home/sthings/.profile\nsource /home/sthings/.profile\n```\n\n## Run Ansible to install tools\n\nInventory\n```bash\ncat \u003c\u003cEOF \u003e /tmp/inventory_raspi\n192.168.1.xxx ansible_user=sthings ansible_password=\u003cpassword\u003e ansible_become_pass=\u003cpassword\u003e ansible_ssh_common_args='-o StrictHostKeyChecking=no'\nEOF\n```\n\nAnsible play\n```bash\ncat \u003c\u003cEOF \u003e /tmp/raspi-betankung.yaml\n- name: Install essential tools on Raspbian\n  hosts: \"{{ target_host | default('all') }}\"\n  become: yes\n  vars:\n    os_packages:\n      - git\n      - curl\n      - unzip\n      - wget\n      - make\n      - g++\n      - python3-pip\n      - python3-dev\n      - cython3\n\n  tasks:\n    - name: Update apt cache\n      ansible.builtin.apt:\n        update_cache: yes\n\n    - name: Install git, curl, and wget etc..\n      ansible.builtin.apt:\n        name: \"{{ os_packages }}\"\n        state: present\nEOF\n```\n\n```bash\nansible-playbook -i /tmp/inventory_raspi /tmp/raspi-betankung.yaml -vv\n```\n\n## Create Directories and download Repos\n\n```bash\nmkdir lib \u0026\u0026\nmkdir homerun-matrix-catcher\n```\n\n```bash\ncd lib \u0026\u0026\ngit clone https://github.com/hzeller/rpi-rgb-led-matrix.git\n```\n\n```bash\ncd /home/sthings/ \u0026\u0026\nwget https://github.com/stuttgart-things/homerun-matrix-catcher/releases/download/0.1.1/homerun-matrix-catcher.tar.gz \u0026\u0026\ntar -xzf homerun-matrix-catcher.tar.gz -C ./homerun-matrix-catcher\n```\n\n## Install python requirements\n\n```bash\npip install -r /home/sthings/homerun-matrix-catcher/requirements_new_raspi.txt\n```\n\nOR\n\n\u003cdetails\u003e\u003csummary\u003eSave requirements to file and scp to new raspi\u003c/summary\u003e\n\n```bash\n# execute on original raspi\npip freeze \u003e /tmp/requirements_new_raspi.txt\nscp /tmp/requirements_new_raspi.txt sthings@192.168.1.xxx:/tmp/requirements_new_raspi.txt\n\n# execute on new raspi\npip install -r /tmp/requirements_new_raspi.txt\n```\n\n\u003c/details\u003e\n\n## Build and install matrix library\n\nReference [Readme](https://github.com/hzeller/rpi-rgb-led-matrix/tree/master/bindings/python)\n\nEdit Makefile\n\n\n```bash\nsudo sed -i 's/^HARDWARE_DESC?=regular/#HARDWARE_DESC?=regular/; s/^#HARDWARE_DESC=adafruit-hat-pwm/HARDWARE_DESC=adafruit-hat-pwm/' /home/sthings/lib/rpi-rgb-led-matrix/lib/Makefile\n```\n\n```bash\nsudo -i\n```\n\n```bash\n# Activate venv while root\ncd /home/sthings \u0026\u0026\nsource .venv/bin/activate\n```\n\n```bash\n# Build and install matrix library\ncd lib/rpi-rgb-led-matrix/bindings/python\nmake build-python \nmake install-python \n```\n\n## Deaktivate Audiodriver\n\n```bash\n# save for reboot\ncat \u003c\u003cEOF \u003e /etc/modprobe.d/blacklist\nsnd_bcm2835\nEOF\n```\n\n```bash\nsudo update-initramfs -u\n```\n\n## Execute\n\nArguments:\n* --profile path/to/rulesfile : Use referenced Rules-File to define which kind of events get displayed on the matrix \n* --generategifs              : To activate generic gif generation of the System and Severity of incoming events\n* --maxtime=100               : To increase or lower the time for pending events. Integer is in seconds\n\n```bash\n# Execute with random generated events\ncd /home/sthings/homerun-matrix-catcher \u0026\u0026\npython3 -E demo_generate.py --profile rules/test-matrix-config.yaml\n```\n\n```bash\n# Execute with redis events and generated gifs\ncd /home/sthings/homerun-matrix-catcher \u0026\u0026\npython3 -E demo_redis.py --profile rules/rules2.yaml --generategifs --maxtime=100 \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuttgart-things%2Fhomerun-matrix-catcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstuttgart-things%2Fhomerun-matrix-catcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuttgart-things%2Fhomerun-matrix-catcher/lists"}