https://github.com/mbta/screens

Screens
https://github.com/mbta/screens

Last synced: about 1 month ago
JSON representation

Screens

• Host: GitHub
• URL: https://github.com/mbta/screens
• Owner: mbta
• License: mit
• Created: 2020-01-17T03:24:33.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T21:14:57.000Z (2 months ago)
• Last Synced: 2024-10-29T23:40:38.515Z (2 months ago)
• Language: Elixir
• Size: 67.4 MB
• Stars: 16
• Watchers: 12
• Forks: 1
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Screens

This application serves real-time information to all of our browser-based screens posted at stops and stations around the system.

If you're looking for the applications that control the LED countdown clocks and the in-station PA system, please see [mbta/realtime_signs](https://github.com/mbta/realtime_signs) and [mbta/signs_ui](https://github.com/mbta/signs_ui).

Some examples of the various client apps, as of January 2023:

| screen type (click for a sample screenshot) | description                                                                                                                   |

| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |

| [Bus E-Ink][bus_eink sample]                | solar-powered E-Ink screens at bus stops                                                                                      |

| [Green Line E-Ink][gl_eink sample]          | solar-powered E-Ink screens at surface-level Green Line stops                                                                 |

| [Bus corridor LCD][bus_shelter sample]      | currently used at stops on the Columbus Ave bus corridor                                                                      |

| [Multimodal LCD][solari sample]             | used at high-traffic transfer stations served by many routes/modes                                                            |

| [Pre-fare duo LCD][pre_fare sample]         | posted outside of fare gates at rapid transit stations; content is split across two portrait-oriented 1080p physical displays |

| ["Digital Urban Panel" LCD][dup sample]     | content appears in rotation with ads on screens posted outside rapid transit station entrances                                |

and more to come!

## Getting Started

See [`docs/getting_started.md`](docs/getting_started.md).

## Architecture

On almost all of our screen types, we use a common "framework" to fetch relevant real-time info for the screen's location, and then determine which pieces of info are most important to riders from moment to moment.

Check out [ARCHITECTURE.md](/ARCHITECTURE.md) for an overview of the application architecture, as well as links to further more detailed documentation.

## Packaging the DUP app

The DUP screens require the client app to be packaged into a single HTML file rather than dynamically served from our Phoenix server.

You can find instructions on the DUP packaging process [here](assets/src/components/v2/dup/README.md).

## Version upgrade guide

You can find some hopefully useful notes on upgrading the project's Elixir version, and possibly other upgrades, [here](docs/version_upgrade.md).

[bus_eink sample]: /docs/assets/sample_app_screenshots/bus_eink.png

[gl_eink sample]: /docs/assets/sample_app_screenshots/gl_eink.png

[bus_shelter sample]: /docs/assets/sample_app_screenshots/bus_shelter.png

[solari sample]: /docs/assets/sample_app_screenshots/solari.png

[pre_fare sample]: /docs/assets/sample_app_screenshots/pre_fare.png

[dup sample]: /docs/assets/sample_app_screenshots/dup.png