Initial commit

README.md

@@ -0,0 +1,110 @@
+# Matrix64 LED Display
+
+Display Home Assistant and Netdata data on a 64x64 LED matrix controlled by a Raspberry Pi.
+
+## Features
+
+- **Weather Display**: Current weather icon and outdoor temperature
+- **Interior Climate**: Temperature and humidity from BTH01-3132 sensor
+- **HDD Temperatures**: From Netdata server
+- **Automatic Brightness**: Adjusts based on ambient light sensor
+
+## Project Structure
+
+```
+matrix64/
+├── matrix.py           # Main entry point
+├── config.py           # Environment configuration
+├── weather_icons.py    # Weather icon drawing functions
+├── home_assistant.py   # Home Assistant API client
+├── netdata.py          # Netdata API client
+├── matrix64.service    # Systemd service file
+├── install.sh          # Installation script
+├── update.sh           # Auto-update script
+├── requirements.txt    # Python dependencies
+├── .env.example        # Configuration template
+└── .env                # Your configuration (gitignored)
+```
+
+## Installation on Raspberry Pi
+
+### Quick Install
+
+```bash
+# Download and run the install script
+curl -sSL https://gitlab.kingstudio.es/jocaru/matrix64/-/raw/master/install.sh | sudo bash
+```
+
+### Manual Install
+
+```bash
+# Clone the repository
+sudo git clone https://gitlab.kingstudio.es/jocaru/matrix64 /opt/matrix64
+cd /opt/matrix64
+
+# Install dependencies
+sudo pip3 install -r requirements.txt
+
+# Create your configuration
+sudo cp .env.example .env
+sudo nano .env  # Edit with your values
+
+# Install and enable the service
+sudo cp matrix64.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable matrix64
+sudo systemctl start matrix64
+```
+
+## Configuration
+
+Edit `/opt/matrix64/.env` with your values:
+
+```env
+# Home Assistant
+HA_TOKEN=your_long_lived_access_token
+HASS_URL=https://your-hass-instance.com
+
+# Entity IDs
+BRIGHTNESS_ENTITY_ID=sensor.your_brightness_sensor
+WEATHER_ENTITY_ID=weather.forecast_home
+INTERIOR_TEMP_ENTITY_ID=sensor.bth01_3132_temperature
+INTERIOR_HUMIDITY_ENTITY_ID=sensor.bth01_3132_humidity
+
+# Netdata
+NETDATA_URL=http://your-netdata-server:19999
+```
+
+## Service Management
+
+```bash
+# Start/stop/restart
+sudo systemctl start matrix64
+sudo systemctl stop matrix64
+sudo systemctl restart matrix64
+
+# Check status
+sudo systemctl status matrix64
+
+# View logs
+sudo journalctl -u matrix64 -f
+```
+
+## Auto-Updates
+
+The install script sets up a cron job that:
+- Checks for updates every 5 minutes
+- Pulls changes if available
+- Restarts the service automatically
+
+To disable auto-updates:
+```bash
+crontab -e  # Remove the matrix64 line
+```
+
+## Manual Execution
+
+```bash
+cd /opt/matrix64
+sudo python3 matrix.py --led-rows=64 --led-cols=64
+```