Introduction to FiestaBoard
FiestaBoard is an open-source server that connects to your split-flap display and lets you control what it shows. You bring the board and the API keys for the services you care about — FiestaBoard handles pulling data from those services and formatting it for your display.
What Does FiestaBoard Do?
If you already own a split-flap display, FiestaBoard gives you a self-hosted platform with a plugin system to get data onto your board:
- 18 Built-in Plugins: Weather, stocks, transit, sports, Disney park wait times, ferry schedules, and more
- WYSIWYG Page Editor: Create pages with a visual editor that shows exactly how content will appear
- Schedule Mode: Visual calendar to schedule which pages display when
- Modern Web UI: Manage pages, configure plugins, and monitor your display
- Docker Ready: One-command deployment on any system
- Plugin Architecture: Easily create your own custom data sources
Quick Start
Prerequisites
- A split-flap display you already own
- Your board's API key
- Docker and Docker Compose installed
Using the Installation Script
The install wizard handles everything — it collects your board API key, creates the configuration, and starts the server:
# Mac/Linux
./scripts/install.sh
# Windows (PowerShell)
.\scripts\install.ps1
Access your FiestaBoard:
- Web UI: http://localhost:8080
- API: http://localhost:8000
- API Docs: http://localhost:8000/docs
Available Plugins
| Plugin | Description |
|---|---|
| 🌤️ Weather | Current conditions, UV index, high/low temps |
| 📈 Stocks | Real-time stock prices with color indicators |
| 🚇 Muni Transit | SF Muni arrival predictions |
| 🏆 Sports Scores | NFL, Soccer, NHL, NBA scores |
| 🌊 Surf Conditions | Wave height and quality ratings |
| 🖖 Star Trek Quotes | Random quotes from TNG, Voyager, DS9 |
| 🚗 Traffic | Travel time with live traffic |
| 💨 Air Quality | AQI and fog conditions |
| 🏠 Home Assistant | Smart home status display |
| 🏰 Disney Parks | Wait times from Queue-Times.com |
| 🚢 WSDOT Ferries | WA State ferry schedules and alerts |
| And more... | 18 plugins total |
Next Steps
- Beginners Guide - Step-by-step setup for new users
- Setup Guide - Detailed installation instructions
- Features Overview - Page editor, scheduling, and more
- Plugin Configuration - Configure your data sources
- Reference - API endpoints, character codes, and colors
- Deployment - Raspberry Pi and production deployment
- Plugin Development - Create custom plugins
- Troubleshooting - Common issues and solutions