sb/Digital_Calendar
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
49 commits 1 branch 0 tags 706 KiB
  • JavaScript 59.6%
  • CSS 20.9%
  • HTML 14.2%
  • Shell 5.3%
Find a file
Exact
Stewart Bennell 53d08eeb50 v2.6.7 — Upcoming zone skips today when Today zone is active 
Extract buildAgendaHtml(startOffset) helper from renderAgenda().
renderAgenda() now checks currentSettings for any zone set to 'today';
if found, portrait .pzone-agenda elements receive buildAgendaHtml(1)
(tomorrow onwards) instead of buildAgendaHtml(0).

Landscape #agenda is always built with offset 0 regardless.
2026-05-25 18:05:17 +10:00
public v2.6.7 — Upcoming zone skips today when Today zone is active 2026-05-25 18:05:17 +10:00
scripts Fix install.sh: add safe.directory for root git operations 2026-05-24 16:07:45 +10:00
.gitignore Build digital calendar display app v1.3.0 2026-05-21 19:11:50 +10:00
CHANGELOG.md v2.6.7 — Upcoming zone skips today when Today zone is active 2026-05-25 18:05:17 +10:00
CLAUDE.md CLAUDE.md: version + changelog must be in same commit as code change 2026-05-24 16:17:45 +10:00
database.js v2.6.5 — Portrait zone height slider in 5% steps 2026-05-24 17:11:58 +10:00
LICENSE Initial commit 2026-05-21 17:24:57 +10:00
package-lock.json Build digital calendar display app v1.3.0 2026-05-21 19:11:50 +10:00
package.json v2.6.7 — Upcoming zone skips today when Today zone is active 2026-05-25 18:05:17 +10:00
README.md v2.4.0 — install/update script + version bump 2026-05-23 08:18:33 +10:00
server.js v2.5.0 — password-protect admin page 2026-05-23 08:44:54 +10:00
TASK.md v2.6.0 — Configurable 4-zone portrait layout 2026-05-24 16:48:49 +10:00

README.md

Digital Calendar Display

A full-screen digital calendar designed to run on a wall-mounted TV or monitor. Built with Node.js + Express, vanilla JS, and SQLite — no build step required.

Features

  • Live clock with seconds display
  • Month mini-calendar with event indicators
  • Upcoming agenda — next 14 days of events
  • Real-time updates via WebSocket — the display refreshes instantly when you add an event
  • Web admin — add, edit, and delete events from any browser on your network
  • iCal / Google Calendar sync — paste a secret iCal URL; events auto-sync hourly
  • Colour-coded events with 8 colour presets

Quick Start

Prerequisites

Install & run

git clone https://github.com/your-username/Digital_Calendar.git
cd Digital_Calendar
npm install
npm start

Open your browser:

Page URL
Display http://localhost:3000/
Admin http://localhost:3000/admin

Development (auto-restart on file changes)

npm run dev

Change the port

PORT=8080 npm start

Google Calendar sync (no API key needed)

  1. Open Google Calendar → Settings → click your calendar name on the left
  2. Scroll to "Secret address in iCal format" → copy the URL
  3. Paste it into the iCal Sync field on the Admin page → click Sync now
  4. Events will auto-sync every hour

Server install / update (Debian / Ubuntu)

One command installs everything — Node.js, the app, and a systemd service — or updates an existing install to the latest version:

curl -fsSL https://git.bennellit.com.au/sb/Digital_Calendar/raw/branch/main/scripts/install.sh | sudo bash

Re-running the same command is always safe; it pulls the latest code and restarts the service.

After the script finishes it prints the display and admin URLs for your server's IP. The service is named digital-calendar and starts automatically on boot.

Useful commands after install:

systemctl status  digital-calendar
journalctl -u digital-calendar -f      # live logs
systemctl restart digital-calendar

Change the port: edit /etc/systemd/system/digital-calendar.service, uncomment the PORT= line, then run sudo systemctl daemon-reload && sudo systemctl restart digital-calendar.

Kiosk / TV setup (Raspberry Pi)

  1. Install Node.js on the Pi and run npm start
  2. Open Chromium in kiosk mode: 
    chromium-browser --kiosk --noerrdialogs --disable-infobars http://localhost:3000
  3. Use a second device (phone/laptop) to visit /admin and manage events

Project structure

server.js        Backend (Express + WebSocket + iCal sync)
database.js      SQLite data layer
public/
  display/       Full-screen display page
  admin/         Admin UI
calendar.db      SQLite database (auto-created, gitignored)

License

MIT © 2026 sb