Skip to content

KganDev/scriptable-dart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

DART Dublin Train Widget

AboutFeaturesInstallationUsageParametersLicenseContact

An iOS Scriptable widget that displays real-time DART (Dublin Area Rapid Transit) train information. Track northbound or southbound trains from your chosen stations, and configure automatic return stations for specific time periods.


DART Dublin Train Widget Screenshot 1 DART Dublin Train Widget Screenshot 2


About the Project

This widget is designed for the Scriptable app on iOS. It presents upcoming DART trains for a selected station, using live data from the Irish Rail API. You can configure a primary station/direction and optionally a secondary "return" station/direction for specific hours of the day.


Features

  • Live train schedules from Irish Rail API
  • Configurable main and return stations
  • Automatic time-based station switching (e.g., from 12:00 to 20:00)
  • Color indicator for return time period
  • Optimized for both Home and Lock Screen widgets
  • Simple, modern design

Installation

1. Open the Scriptable app on your iOS device.
2. Create a new script and paste in the contents of dartWidget.js.
3. Save the script with a descriptive name, such as DART Dublin Train Widget.
4. Add the widget to your Home or Lock Screen, and select this script in the widget’s settings.


Usage

1. On your iOS device, enter edit mode on the Home or Lock Screen.
2. Add or edit a Scriptable widget.
3. Select the DART Dublin Train Widget script from the widget configuration.
4. Enter your desired parameters (see below) in the parameter field.

The widget will then show real-time train updates for your configured station(s). During your specified hours, it automatically switches to your return station/direction.


Parameters

Provide widget parameters as a comma-separated list.

Example:

Connolly, Southbound, Home, Pearse, 12, 20
Position Parameter Example Value Description
1 Starting Station Connolly, Pearse, Tara Street Main station to check train times
2 Direction Northbound or Southbound Direction of trains to display
3 Widget Type Home, Lock, true, false, etc. Widget style (see below for accepted values)
4 Return Station Bray, Connolly, Tara Street Optional, station to switch to during return hours
5 Return Start 12 Hour (24h) when to begin using return station/direction
6 Return End 20 Hour (24h) when to stop using return station/direction

Accepted Widget Type Values:

  • For Home: Home, true, homescreen, h
  • For Lock: Lock, false, lockscreen, l

If you omit parameters, the script will fall back to defaults.


Example

Typical usage:

Connolly, Southbound, Home, Pearse, 12, 20
  • Shows southbound trains from Connolly by default.
  • From 12:00 to 20:00, will show northbound trains from Pearse.

License

This project is licensed under the MIT License.


Contact

Maintainer: KganDev
Project Repository: github.com/KganDev/scriptable-dart

About

DART Dublin Train Widget for iOS (Scriptable)

Resources

License

Stars

Watchers

Forks

Packages

No packages published