≪ View Page

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
members:sparky:projects [2026/06/03 20:45] – Sparkymembers:sparky:projects [2026/09/14 23:48] (current) – Sparky
Line 11: Line 11:
 **How to interact with it at dma.computer:** **How to interact with it at dma.computer:**
  
 +- **Press a button**: A 15-key Stream Deck next to the sign switches which route it shows. Top row, left to right: Link, Bus 8, Bus 10, Bus 12, Streetcar. The live route lights up bright with a white border; the rest stay dimmed. Bottom-right key blanks the display.
 - **View the display**: The transit board is on the network at `transittracker-display.user.dma.computer` (10.20.110.197) - **View the display**: The transit board is on the network at `transittracker-display.user.dma.computer` (10.20.110.197)
 - **API endpoint**: Real-time feed data available at `http://transittracker-pi.int.dma.computer:3000/feeds` - **API endpoint**: Real-time feed data available at `http://transittracker-pi.int.dma.computer:3000/feeds`
Line 23: Line 24:
  
 The board shows arrival times for local transit agencies and updates automatically. Perfect for checking your commute before heading out! The board shows arrival times for local transit agencies and updates automatically. Perfect for checking your commute before heading out!
 +
 +**Route presets:**
 +
 +| Preset | Routes | Stops |
 +| --- | --- | --- |
 +| Link | 1 Line + 2 Line | Capitol Hill, both directions |
 +| Bus 8 | KCM 8 | E John St & Broadway, both bays |
 +| Bus 10 | KCM 10 | E Pine St & 12th Ave, both directions |
 +| Bus 12 | KCM 12 | E Pine St & 12th Ave, both directions |
 +| Streetcar | First Hill Streetcar | Broadway & Pike-Pine, both directions |
 +
 +**Home Assistant control:**
 +
 +You can do everything the Stream Deck does from Home Assistant, which is handy if you are not standing next to the sign.
 +
 +- `select.transit_tracker_cycling_transit_preset` — switches the route preset
 +- `switch.hangout_transit_tracker_cycling_display_power` — blanks the display without cutting power
 +- `number.hangout_transit_tracker_cycling_display_brightness` — brightness, 0-255
 +
 +The Stream Deck talks to these entities over the Home Assistant REST API. It runs as a container on the same Pi as the API, and it mirrors Home Assistant, so switching a preset from either place updates both.
 +
 +**Troubleshooting:**
 +
 +If the sign shows "no upcoming arrivals" for some routes but not others, the routes that break usually share a feed. Work through these in order:
 +
 +1. Query the API for a broken route and for a route on the same feed the sign never asks for. If the second one works, the data is fine and something is caching empty results.
 +2. Check for a stuck feed sync: `SELECT feed_code, locked_at, now() - locked_at FROM sync_lock;` A row older than a few hours is stale, and it blocks that feed from syncing again until you clear it.
 +3. Check the data has not aged out: `SELECT feed_code, min(start_date), max(end_date) FROM calendar GROUP BY feed_code;` and compare to today. GTFS feeds expire, and an agency service change replaces them.
 +4. To force a sync: `docker exec transit-tracker-api-api-1 node dist/cli sync --force --feed <code>`
 +5. A sync run this way is invisible to the running API for up to 12 hours, because schedule results are cached in memory as well as in Redis. Restart the API container to pick them up: `docker restart transit-tracker-api-api-1`
  
 **Repos:** **Repos:**
Line 28: Line 59:
 - API: [github.com/sparkyfen/transit-tracker-api](https://github.com/sparkyfen/transit-tracker-api) (fork of [tjhorner/transit-tracker-api](https://github.com/tjhorner/transit-tracker-api)) - API: [github.com/sparkyfen/transit-tracker-api](https://github.com/sparkyfen/transit-tracker-api) (fork of [tjhorner/transit-tracker-api](https://github.com/tjhorner/transit-tracker-api))
 - ESPHome firmware: [github.com/sparkyfen/esphome-transit-tracker](https://github.com/sparkyfen/esphome-transit-tracker) - ESPHome firmware: [github.com/sparkyfen/esphome-transit-tracker](https://github.com/sparkyfen/esphome-transit-tracker)
 +- Stream Deck controller: [github.com/sparkyfen/streamdeck-transit](https://github.com/sparkyfen/streamdeck-transit)
  
 --- ---
Line 63: Line 95:
  
 ### TRMNL E-Ink Dashboard ### TRMNL E-Ink Dashboard
 +
 +<WRAP alert>
 +**Deprecated.** The space runs a different e-ink display now. This section stays for reference. Do not use it as current documentation.
 +</WRAP>
  
 ![](/:members:sparky:img_7283.jpg) ![](/:members:sparky:img_7283.jpg)
Line 74: Line 110:
 - **Plugin ecosystem**: Supports integrations with Google Calendar, Home Assistant, weather stations, and community-created plugins - **Plugin ecosystem**: Supports integrations with Google Calendar, Home Assistant, weather stations, and community-created plugins
 - **Developer friendly**: Create custom plugins using HTML/JSON in under 5 minutes - **Developer friendly**: Create custom plugins using HTML/JSON in under 5 minutes
- 
-**Want to display something specific?** Reach out to Sparky on Zulip or Signal! 
  
 Learn more at [usetrmnl.com](https://usetrmnl.com) Learn more at [usetrmnl.com](https://usetrmnl.com)