Welcome to Dan's Christmas Lights, a live visitor tracking project showcasing real-time crowd analytics from our holiday display.
This project combines:
- Live Visitor Data: Detecting anonymous mobile device signals to estimate crowd size.
- Visualizations: Custom Chart.js dashboards powered by Google Sheets data.
- Web Hosting: Hosted freely and openly on GitHub Pages.
Visit the live site to see current activity: https://danslights.com
docs/: The public-facing website code (HTML/CSS/JS) for GitHub Pages.signals-collector/: The Python collector script for the Baldrick Signals Board. It polls the device and uploads data to Google Sheets.
This section describes how to set up the signals-collector on a Raspberry Pi or similar Linux device to interface with the Baldrick Signals Board.
- A Raspberry Pi (or any Linux server/computer) with Python 3.7+.
- Network access to the Baldrick Signals Board (default IP:
192.168.100.80). - A Google Cloud Service Account with Google Sheets API enabled.
We provide a helper script to set up the environment, dependencies, and background service automatically.
# Clone the repo
git clone https://github.com/dhooper6430/danslights.git
cd danslights/signals-collector
# Make the installer executable and run it
chmod +x install.sh
./install.shThe script will:
- Create a Python virtual environment (
venv). - Install required Python packages.
- Create a default
.envconfiguration file. - Generate and install the
signals-collectorsystemd service for your user.
After running the installer, you must configure the collector:
- Google Credentials: Place your Google Service Account JSON key file in the
signals-collector/folder and name itcredentials.json. - Environment Variables: Edit the newly created
.envfile:nano .env
- Update
DEVICE_IP(default: 192.168.100.80). - Update
GOOGLE_SHEET_NAMEif your target sheet has a different name.
- Update
- Share Sheet: Open your Google Sheet in the browser and Share it with the
client_emailaddress found inside yourcredentials.json(give "Editor" access).
Once configured, start the background service:
sudo systemctl start signals-collectorUseful Commands:
- Check Status:
sudo systemctl status signals-collector - View Logs:
journalctl -u signals-collector -f - Stop Service:
sudo systemctl stop signals-collector
The docs/ folder contains the source for the GitHub Pages site.
index.html: Main dashboard entry point.js/main.js: Fetches data from the published Google Sheet (via CSV export link) and renders the charts.