simpleSubwayStatus

Simple MTA status alerts for your line of choice, with filtering and display options.

MTA Status Page Screenshot

Simple Features

Pulls real-time alerts from MTA Subway Alerts feed.
Filter by Line Group: Easily filter alerts by standard MTA line groupings (e.g., 1/2/3, A/C/E, B/D/F/M, etc.) including Shuttles and SIR.
Toggle Future Alerts: Choose to show or hide alerts scheduled for a future date/time.
Clear "No Alerts" Indication: Displays a message and graphic when no alerts match your current filter settings.
Expandable Details: Click any alert summary to view the full description.
Relative Timestamps: See how long ago an alert was issued or when a future alert is scheduled to start.
Mobile and Desktop Viewports: Responsive design for various screen sizes.
Fixed Controls: Refresh, Show All, and Future Alert toggle are always accessible at the bottom.
Solarized whether you like it or not.

Web server with PHP support (PHP 7.0 or higher recommended, cURL extension recommended for better reliability).
A modern web browser.

Clone this repository or download the files to your web server's document root (or a subdirectory).
Ensure the web server has read permissions for all files (index.html, style.css, mtalogo.png, no_alerts.png) and execute permissions for status.php.
Add Image: Place an image named no_alerts.png in the same directory. This will be displayed when no alerts are found.
(Optional) MTA API Key: If you have an MTA API key, edit status.php and add it to the cURL or file_get_contents request headers for potentially better rate limits or access.
Access the index.html page through your web browser via the web server.

.
├── index.html
├── style.css
├── status.php
├── mtalogo.png
├── no_alerts.png
└── README.md

All current and future alerts are shown by default on page load.
Use the filter buttons at the top to show alerts only for specific line groups (e.g., clicking the 'ACE' button shows alerts affecting A, C, or E lines). Shuttles and SIR are filtered individually.
Click on an alert summary (the card itself) to expand and view the detailed description. Click again to collapse.
Alerts show when they were issued or when they are scheduled to start.

Refresh: Click the circular arrow button to fetch the latest alerts immediately.
Show All: Click this button to clear any active line filters and display all alerts (respecting the Future Alerts toggle).
Show Future Toggle: Use the switch to include or exclude alerts that are scheduled to begin at a future time.

Acts as a simple backend to fetch data from the official MTA alert feed (https://api-endpoint.mta.info/Dataservice/mtagtfsfeeds/camsys%2Fsubway-alerts.json).
This avoids potential CORS (Cross-Origin Resource Sharing) issues that would occur if the browser tried to fetch directly from mta.info.
Includes basic error handling and timeout settings. Recommends using the cURL extension if available.
Sets Cache-Control headers to discourage aggressive caching of the status data.

The application parses the JSON response from the MTA feed. JavaScript handles filtering based on:
Selected line groups stored in activeFilters.
The state of the "Show Future Alerts" toggle (activeFilters.showFuture).
The active_period[0].start timestamp of each alert.
The "No Alerts" message is shown dynamically when the filtering results in zero visible alert cards.

Lines are grouped and ordered based on common MTA conventions:
1, 2, 3 (Red)
4, 5, 6 (Green)
7 (Purple)
A, C, E (Blue)
G (Lime Green)
B, D, F, M (Orange)
N, Q, R, W (Yellow)
J, Z (Brown)
L (Gray)
S (42nd St Shuttle - Gray)
H / sR (Rockaway Shuttle - Gray)
FS / sF (Franklin Ave Shuttle - Gray)
SI (Staten Island Railroad - Blue)
Colors used are based on official MTA branding. Filtering applies to all lines within a clicked group (except for individual shuttles/SIR).