Manage events and schedules for your RGB matrix displays
Connect to Your GitHub Repository
What is SCREENY?
A web-based manager for your RGB matrix displays. Create events, manage schedules, and see real-time previews of how they'll look on your 64×32 LED matrix.
Events
Add and manage ephemeral events with custom text, colors, and icons
Schedules
Create daily schedules with time-based activities and progress bars
Live Preview
See exactly how your content will appear on the RGB matrix display
SCREENY Manager
Manage events and schedules for your RGB matrix displays
Your Events
Current Events
Loading events from GitHub...
No events found. Click the "+ NEW" button to create your first event!
Add New Event
0/12
0/12
Preview
This is how your event will appear on the display
Schedule Manager
Schedule Files
Loading schedules...
No schedules found.
Edit Schedule
Schedule Items
MonMonday
TueTuesday
WedWednesday
ThuThursday
FriFriday
SatSaturday
SunSunday
Timeline View
Preview
Edit Item
Edit Item
Running From: :to:
Template Manager
Loading templates...
No templates found. Save a schedule as a template to get started!
CTA Transit Routes
Manage bus and train routes displayed on your matrix
Your Transit Routes
Loading transit routes from GitHub...
No transit routes configured. Click "+ Add Route" to add your first route!
Add New Transit Route
Display Configuration
Control display settings for your matrix
Loading...
Loading...
Investment Stocks
Manage stock tickers displayed on your matrix
Your Stocks
Loading stocks from GitHub...
No stocks configured. Click "+ Add Stock" to add your first stock!
Add New Stock
Short label to show instead of symbol
Highlighted stocks are displayed individually instead of in groups of 3
Data Validation
Starting validation...
Help & Documentation
Getting Started
1. Fork the Data Repository
The data repository contains your events, schedules, stocks, and images. To get your own copy:
Go to the original repository on GitHub
Click the "Fork" button in the top right
This creates your own copy under your GitHub account
2. Create a GitHub Token
You need a Personal Access Token to let the manager read/write your data:
Go to GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
Click "Generate new token"
Name it something like "SCREENY Manager"
Under "Repository access", select "Only select repositories" and choose your forked repo
Under "Permissions", grant Read and Write access to "Contents"
Click "Generate token" and copy it somewhere safe
3. Login to the Manager
On the login screen, enter:
Username: Your GitHub username
Repository: Your forked repo name (e.g., "pantallita-events")
Token: The token you just created
Your credentials are stored locally in your browser and never sent anywhere except GitHub's API.
Using the Manager
Events
Events are special occasions displayed on your matrix (birthdays, holidays, etc.).
One-Time Events: Specific date events (e.g., "2025-12-25")
Recurring Events: Annual events by month/day (e.g., every Dec 25)
Each event has two lines of text (max 12 characters each), a color, and an image
Optional time window to only show during certain hours
Schedules
Schedules define daily routines displayed on the matrix.
Default Schedule: Applies every day based on day-of-week settings
Date-Specific Schedules: Override for specific dates
Each item has a time range, image, and optional progress bar
Use the timeline view to visualize your day
Save schedules as templates for reuse
Stocks
Display stock tickers, forex rates, commodities, or crypto prices.
Regular stocks display in groups of 3
Highlighted stocks (⭐) display individually
Drag to reorder display sequence
Use "Lookup" to validate symbols and auto-fill names
Transits
Display CTA bus/train arrival times.
Add routes with stop numbers and display labels
Set minimum time threshold (don't show if arriving too soon)
Optional commute hours to only show during certain times
Configuration
Control what appears on your display.
Toggle features on/off (weather, stocks, transit, etc.)
Set display frequencies (how often stocks/transit cycle)
If you have multiple displays, switch between them with the toggle
Raspberry Pi Display Setup
Hardware Requirements
Raspberry Pi (3B+ or newer recommended)
64x32 RGB LED Matrix panel
Adafruit RGB Matrix Bonnet or HAT
5V power supply (4A+ recommended)
Initial Setup
Flash Raspberry Pi OS Lite to an SD card
Enable SSH and configure WiFi
Install the RGB matrix library
Clone the display software repository
Configure with your GitHub repo details
Adding Custom Images
Images must be added to both the Pi and your GitHub repo:
Create your image as a BMP file:
Event images: 27×28 pixels
Schedule images: 40×28 pixels
8-bit indexed color, black = transparent
Copy to Pi: scp image.bmp pi@[IP]:/home/pi/pantallita/img/events/
Upload to GitHub repo in the same img/events/ or img/schedules/ folder
Refresh the manager to see the new image in dropdowns
Display Token (Read-Only)
For the Pi, create a separate fine-grained token with read-only "Contents" permission. This is safer since the Pi only needs to read data, not modify it.
Troubleshooting
Manager won't load / shows errors
Check your token hasn't expired
Verify the repository name is correct
Make sure your token has "Contents" read/write permission
Try logging out and back in
Images not showing in preview
Images must be uploaded to the GitHub repo's img/ folder
For private repos, images are fetched via API (may take a moment)
Check browser console for 404 errors
Display not updating
The Pi fetches new data periodically (usually every few minutes)
Check the Pi's internet connection
Verify the CSV files in your repo look correct
Check the Pi's logs for errors
Config not loading on mobile
Mobile browsers (especially Safari) may clear localStorage
Avoid using Private/Incognito mode
Add the site to your home screen for better persistence
Validation errors
Use "Validate Data" in the footer to check for issues
Common issues: missing images, past events, duplicate schedule names