Skip to content

Commit 210a981

Browse files
TheInfamousToToTheInfamousToTo
committed
🎉 Major Update: Added 15 Animations, TV-Style Scrolling & Enhanced Features
✨ New Features: - TV news ticker style scrolling text (synchronized) - 15 entertaining animations (Matrix, Anime, One Piece, Super Sonico, etc.) - 3-minute animation intervals for burn-in prevention - 80% brightness optimization - Smooth scrolling with 0.15s refresh rate 🎮 Animations Added: - Matrix Digital Rain - Bouncing Ball & Sine Waves - Starfield & Clock animations - Anime Hearts, Kawaii Faces, Neko Ears - One Piece Luffy fighting scenes - Super Sonico character animation - Seductive eyes & bouncing curves - Wave interference & progress bars - GitHub creator signature 🛠️ Technical Improvements: - Perfect text synchronization fix - Optimized display performance - Clean systemd service file - Organized project structure - Updated comprehensive README 🗑️ Cleaned Up: - Removed complex burn-in prevention files - Simplified to core functionality - Removed outdated documentation
1 parent 5aa7cb5 commit 210a981

7 files changed

Lines changed: 1071 additions & 1001 deletions

File tree

‎BURN_IN_PREVENTION.md‎

Lines changed: 0 additions & 144 deletions
This file was deleted.

‎README.md‎

Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
![Raspberry Pi OLED System Info Display Logo](./assets/logo.png)
2+
3+
# Pi HAT Screen - OLED System Info Display
4+
5+
An entertaining system information display for Raspberry Pi with 128x32 I2C OLED screen featuring scrolling text, burn-in prevention animations, and auto-start functionality.
6+
7+
## ✨ Features
8+
9+
* **📊 System Info:** IP Address, CPU Usage, Temperature, Time, RAM Usage
10+
* **📰 Scrolling Display:** TV news ticker style synchronized scrolling text
11+
* **🎬 15 Animations:** Matrix rain, bouncing ball, anime characters, One Piece Luffy, Super Sonico, and more
12+
* **🛡️ Burn-in Prevention:** Automatic animations every 3 minutes to extend OLED lifespan
13+
* **🔧 Auto-Start:** Systemd service runs on boot
14+
* **⚙️ Optimized:** 80% brightness, smooth scrolling, virtual environment
15+
16+
## 🎮 Animations
17+
18+
The system includes 15+ entertaining animations that run every 3 minutes:
19+
20+
* Matrix Digital Rain
21+
* Bouncing Ball with Trails
22+
* Sine Wave Patterns
23+
* Starfield Effect
24+
* Analog Clock
25+
* System Progress Bars
26+
* Anime Hearts & Kawaii Faces
27+
* Neko Cat Ears
28+
* One Piece Luffy Fighting
29+
* Super Sonico Character
30+
* Seductive Eyes & Bouncing Curves
31+
* Wave Interference
32+
* GitHub Creator Signature
33+
34+
## 🔧 Requirements
35+
36+
**Hardware:**
37+
38+
* Raspberry Pi (any model with I2C support)
39+
* 128x32 I2C OLED Display (SSD1306)
40+
* Jumper wires
41+
42+
**Software:**
43+
44+
* Raspberry Pi OS
45+
* Python 3 + pip
46+
47+
## 📡 Wiring
48+
49+
| OLED Pin | Raspberry Pi Pin |
50+
|----------|------------------|
51+
| VCC | 3.3V (Pin 1) |
52+
| GND | GND (Pin 6) |
53+
| SCL | GPIO3 (Pin 5) |
54+
| SDA | GPIO2 (Pin 3) |
55+
56+
## 🚀 Quick Install
57+
58+
```bash
59+
# 1. Enable I2C
60+
sudo raspi-config
61+
# Navigate to: Interface Options -> I2C -> Yes
62+
63+
# 2. Install dependencies
64+
sudo apt update && sudo apt install python3-pip python3-venv ttf-dejavu -y
65+
66+
# 3. Clone repository
67+
git clone https://github.com/TheInfamousToTo/Pi-HAT-Screen.git
68+
cd Pi-HAT-Screen
69+
70+
# 4. Setup virtual environment
71+
python3 -m venv ~/screen_env
72+
source ~/screen_env/bin/activate
73+
pip install Pillow adafruit-circuitpython-ssd1306 psutil
74+
75+
# 5. Create systemd service
76+
sudo cp info-screen.service /etc/systemd/system/
77+
sudo systemctl daemon-reload
78+
sudo systemctl enable info-screen.service
79+
sudo systemctl start info-screen.service
80+
81+
# 6. Check status
82+
sudo systemctl status info-screen.service
83+
```
84+
85+
## 🛠️ Service Management
86+
87+
```bash
88+
# Start service
89+
sudo systemctl start info-screen.service
90+
91+
# Stop service
92+
sudo systemctl stop info-screen.service
93+
94+
# Check status
95+
sudo systemctl status info-screen.service
96+
97+
# View logs
98+
sudo journalctl -u info-screen.service -f
99+
```
100+
101+
## 🎯 Configuration
102+
103+
The main script (`info-screen.py`) includes:
104+
105+
* Scrolling speed adjustment
106+
* Animation timing (3 minutes default)
107+
* Brightness control (80% default)
108+
* Display refresh rate (0.15s for smooth scrolling)
109+
110+
## 🔍 Troubleshooting
111+
112+
**Permission Issues:**
113+
```bash
114+
sudo usermod -a -G i2c,gpio $USER
115+
sudo reboot
116+
```
117+
118+
**Service Not Starting:**
119+
```bash
120+
sudo journalctl -u info-screen.service -f
121+
```
122+
123+
**Display Issues:**
124+
```bash
125+
# Check I2C devices
126+
sudo i2cdetect -y 1
127+
```
128+
129+
## 📁 Project Structure
130+
131+
```
132+
Pi-HAT-Screen/
133+
├── info-screen.py # Main script with animations
134+
├── info-screen.service # Systemd service file
135+
├── README.md # This file
136+
├── LICENSE # MIT License
137+
├── version # Version info
138+
└── assets/
139+
└── logo.png # Project logo
140+
```
141+
142+
## 🤝 Contributing
143+
144+
Created by **TheInfamousToTo**
145+
146+
Feel free to submit issues and pull requests!
147+
148+
## 📄 License
149+
150+
MIT License - see LICENSE file for details.
151+
152+
---
153+
154+
**Enjoy your animated Pi HAT Screen! 🎉**

0 commit comments

Comments
 (0)