Timeframe

An e-paper calendar, weather, and smart home family dashboard

Project goals

• Serve as a test bed for learning new technologies.
• Longevity: I expect to run this application for years, if not decades.
• Stability: I expect the application to run without maintenance indefinitely.
• Availability: 100% uptime.
• Fault tolerance: the application functions when no internet connection is available.

Architecture

• Signage endpoints
  • Visionect 13" displays (/thirteen)
    • Fetched by Visionect Software Suite running on local network and displayed on 13" Place and Play devices. Fetch interval is currently 10m.
  • Boox Mira Pro (/mira)
    • Fetched by a client Mac Mini with a Boox Mira Pro (25.3" 3200x1800px e-Paper display) running Google Chrome full screen.
    • Self-refreshes entire screen every 2s.

Dependencies

• Home Assistant installation (If you do not have a Home Assistant instance you can run a Dockerized version for local development purposes with docker run -d --restart=always -p 8123:8123 homeassistant/home-assistant)
• Apple WeatherKit API key

Local development

Configuration

1. Create config.yml from config.yml.example
2. Fill out home_assistant_token by creating a long-lived access token under Home Assistant > Profile > Security

Setup

1. bundle install
2. rails s
3. Visit http://localhost:3000/mira or http://localhost:3000/thirteen

Testing

bundle exec rake

Deploying

To fetch the latest version: git fetch --all && git reset --hard origin/main

To upgrade Visionect: docker-compose pull && docker-compose up -d

Rails server: RAILS_ENV=production rails s -p 80 -b 0.0.0.0 --no-log-to-stdout