aly.codes / marta-us-plasmoid
KDE Plasma Widget for displaying real time arrivals for MARTA buses.
kde plasma marta transit
0
Fork 0

Configure Feed

Select the types of activity you want to include in your feed.

JavaScript 90.9%
QML 8.8%
Nix 0.3%
2 1 0

Clone this repository

https://git.vm.fail/aly.codes/marta-us-plasmoid https://git.vm.fail/did:plc:75wu4rjinndx5lpaos3kwt52
ssh://git@knot1.tangled.sh:2222/aly.codes/marta-us-plasmoid ssh://git@knot1.tangled.sh:2222/did:plc:75wu4rjinndx5lpaos3kwt52

For self-hosted knots, clone URLs may differ based on your setup.


Download tar.gz Download .zip
README.md

MARTA Bus Arrivals#

A KDE Plasma 6 widget for real-time MARTA bus arrivals. Configure one or more stop IDs, label each with the direction you use, and see the next arrivals for every configured stop.

The desktop widget shows the full departure board. In a panel, it appears as the authorized MARTA rainbow mark; click it to open the board in a popup.

Requirements#

  • KDE Plasma 6
  • Network access to MARTA's GTFS-Realtime feed
  • kpackagetool6 to install the widget

Install#

Download a .plasmoid file from the GitHub Releases page, then run:

kpackagetool6 --type Plasma/Applet --install marta-bus-arrivals-X.Y.Z.plasmoid

To upgrade an existing installation, use --upgrade instead:

kpackagetool6 --type Plasma/Applet --upgrade marta-bus-arrivals-X.Y.Z.plasmoid

To install directly from a source checkout:

kpackagetool6 --type Plasma/Applet --upgrade /path/to/marta-plasmoid

Remove the widget with:

kpackagetool6 --type Plasma/Applet --remove io.github.alyraffauf.martabusarrivals

Configure Stops#

Open the widget settings and add each MARTA stop ID. Give it a direction name such as Westbound or Eastbound; this is the primary heading in the board. The widget supplements that direction with MARTA's official stop name from its bundled static GTFS data.

New installations intentionally include no stops. Your configured stops are stored locally in Plasma configuration and are never part of the repository or a release artifact.

The settings page also controls:

  • arrivals shown per stop, defaulting to three
  • feed refresh interval, defaulting to 30 seconds

Data, Privacy, and Branding#

Arrival predictions come from MARTA's GTFS-Realtime trip-update feed. Official stop names are generated from MARTA's static GTFS feed and bundled with the widget so the applet never needs to download and unpack the 20 MB archive while running.

The widget does not use accounts, analytics, or remote storage. Configured stop IDs are retained only in the local Plasma widget configuration. Not endorsed by MARTA.

Troubleshooting#

  • No upcoming arrivals: Confirm the stop IDs in Settings and check MARTA service status. The feed may not have active predictions for every stop.
  • Last updated ...: The widget kept the last successful results after a refresh failed. Use the refresh button to retry.
  • Panel popup is too small: Update to the latest release. The panel mark opens the board in Plasma's expanded popup.

Development#

See CONTRIBUTING.md for the development environment, validation commands, tests, and static stop-data updates. See docs/architecture.md for component boundaries and docs/releasing.md for the release process.