➡️ Documentation | Quick Start | Configuration | Questions and Support ⬅️





Create human-readable, user-friendly transit timetables in HTML, PDF or CSV format directly from GTFS.

See gtfstohtml.com for full documentation.

Most transit agencies have schedule data in GTFS format but need to show each route's schedule to users on a website. GTFS-to-HTML automates the process of creating nicely formatted HTML timetables for inclusion on a transit agency website. This makes it easy to keep timetables up to date and accurate when schedule changes happen and reduces the likelihood of errors.

Features

Configurable and customizable

gtfs-to-html has many options that configure how timetables are presented. It also allows using a completely custom template which makes it easy to build chunks of HTML that will fit perfectly into any website using any HTML structure and classes that you'd like. Or, create printable PDF versions or CSV exports of timetables using the outputFormat config option.

Accessibility for all

gtfs-to-html properly formats timetables to ensure they are screen-reader accessible and WCAG 2.0 compliant.

Mobile responsiveness built in

Built-in styling makes gtfs-to-html timetables ready to size and scroll easily on mobile phones and tablets.

Schedule changes? A cinch.

By generating future timetables and including dates in table metadata, your timetables can appear in advance of a schedule change, and you can validate that your new timetables and GTFS are correct.

Auto-generated maps

gtfs-to-html can also generate a map for each route that can be included with the schedule page. The map shows all stops for the route and lists all routes that serve each stop. Maps can also show realtime vehicle locations and predicted arrival times from GTFS-realtime data.

Note: If you only want maps of GTFS data, use the gtfs-to-geojson package instead and skip making timetables entirely. If offers many different formats of GeoJSON for routes and stops.

gtfs-to-html uses the node-gtfs library to handle importing and querying GTFS data.

GTFS-to-HTML on the web

You can now use gtfs-to-html without actually downloading any code or doing any configuration. run.gtfstohtml.com provides a web based interface for finding GTFS feeds for agencies, setting configuration and then generates a previewable and downloadable set of timetables.

Current Usage

Many transit agencies use gtfs-to-html to generate the schedule pages used on their websites, including:

• Advance Transit (Vermont)
• Basin Transit (Morongo Basin, California)
• Brockton Area Transit Authority
• BusWay – CIRA (Aveiro, Portugal)
• Capital Transit (Helena, Montana)
• Capital Transit (Juneau, Alaska)
• Central Transit (Ellensburg, Washington)
• County Connection (Contra Costa County, California)
• El Dorado Transit
• Greater Attleboro-Taunton Regional Transit Authority
• Humboldt Transit Authority
• Kings Area Rural Transit (KART)
• Lowell Regional Transit Authority
• Madera County Connection
• Marin Transit
• Morongo Basin Transit Authority
• Mountain Transit
• Mountain View Community Shuttle
• MVgo (Mountain View, CA)
• NW Connector (Oregon)
• Palo Verde Valley Transit Agency
• Petaluma Transit
• Rogue Valley Transportation District (Medford, OR)
• rabbittransit (York and Adams County, PA)
• RTC Washoe (Reno, NV)
• Santa Barbara Metropolitan Transit District
• Sonoma County Transit
• Tahoe Transportation District
• Tahoe Truckee Area Regional Transit
• Transcollines
• Tulare County Area Transit
• Victor Valley Transit
• Worcester Regional Transit Authority

Are you using gtfs-to-html? Let us know via email gtfs@blinktag.com or via opening a github issue or pull request if your agency is using this library.

gtfs-to-html is used as an integral part of transit-custom-posts - a GTFS-optimized Wordpress plugin for transit websites.

Installation, Configuration and Usage documentation

See GTFS-to-HTML Documentation

Changelog

See Changelog

Contributing

Pull requests are welcome, as well as feedback and reporting issues.

Tests

npm test

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Updated

• Dependency updates

[2.10.12] - 2025-05-20

Fixed

• If a stop is marked as a timepoint in any trips, treat it as a timepoint in all trips for sorting purposes.

Updated

• Dependency updates

[2.10.11] - 2025-04-17

Updated

• Dependency updates
• Remove package-lock.json
• Typescript updates

[2.10.10] - 2025-02-25

Updated

• Dependency updates

[2.10.9] - 2025-01-29

Fixed

• Template path detection when installed globally

Updated

• Dependency updates

[2.10.8] - 2025-01-11

Updated

• Move timetablepage sort logic to formatting_functions.pug
• Dependency updates

[2.10.7] - 2025-01-02

Fixed

• Better support for GTFS with multiple agencies

Updated

• Dependency updates

[2.10.6] - 2025-01-01

Fixed

• Handle stoptimes with empty arrival/departure time

Updated

• Dependency updates

[2.10.5] - 2024-12-09

Fixed

• Use sanitize-html for timetable notes

Updated

• Dependency updates

[2.10.4] - 2024-11-18

Updated

• Dependency updates

[2.10.3] - 2024-11-12

Updated

• Updated additional files documentation
• Documentation site dependency updates
• Better map legend on mobile
• Dependency updates
• Use dompurify instead of insane

[2.10.2] - 2024-10-28

Changed

• Moved formatTripName to formatting_functions.pug
• Added trip-name class to trip names to make it easier to hide

Updated

• Dependency updates

[2.10.1] - 2024-10-24

Updated

• Improved non-topological sort warning
• Log all warnings to logfile
• Change to logging functions
• Dependency updates

[2.10.0] - 2024-10-18

Updated

• Fix for stop popup realtime trip updates
• Use maplibregl
• Add geocoder to system map
• Dependency updates

[2.9.15] - 2024-10-16

Updated

• Dependency Updates
• Upgrade to Express 5.0 for demo app
• Improved stop highlight styles on map
• Better error handlers for demo app

Added

• Warning about toposort stop order failure
• Add Realtime trip updates to stop popups
• Add types for GTFS files

[2.9.14] - 2024-10-11

Updated

• Dependency Updates

Added

• overwriteExistingFiles config option

[2.9.13] - 2024-09-27

Updated

• Get a vehicle bearing based on next stop location
• Better anchor position for vehicle marker popup
• Better vehicle popup content
• Trigger vehicle popup on click
• Use rem for font size
• Dependency Updates

[2.9.12] - 2024-09-23

Fixed

• Deduplicate excluded/included calendar_dates

Updated

• Minor style change
• Dependency Updates

[2.9.11] - 2024-09-18

Fixed

• Fix for vehicle popups when toggling maps
• Handle timetables with no direction_name in menu

Updated

• Dependency updates for documentation site
• Use jQuery instead of $
• Improvements to vehicle popups

[2.9.10] - 2024-09-17

Updated

• Handle only some GTFS-Realtime URLs
• Dependency Updates

[2.9.9] - 2024-09-14

Updated

• Route color swatch styles
• Dependency Updates

Added

• Highlight stop row/column on map click
• Use anchorme for links in service alerts

Fixed

• Service alert filtering by stop

[2.9.8] - 2024-09-10

Updated

• Add release-it hook
• Create config-sample-full.json example

[2.9.7] - 2024-09-10

Fixed

• Fix for zipped CSV and PDF output

Updated

• Dependency updates

[2.9.6] - 2024-09-09

Added

• Add html lang attribute
• Add html title attributes to pages

Updated

• Service alert and timetable styles

[2.9.5] - 2024-09-08

Updated

• Update to config types

[2.9.4] - 2024-09-08

Added

• outputPath config option
• Return path to timetable output
• Support for GTFS-Realtime Alerts

Fixed

• Format timetable_id in template for HTML

Updated

• Update to map route/trip/stop data format
• Move PDF styles to print styles

[2.9.3] - 2024-09-07

Fixed

• Fix path to template folder
• Update timetablepage template for maps

[2.9.2] - 2024-09-06

Fixed

• Update files list in package.json

Updated

• Dependency updates

[2.9.1] - 2024-09-05

Fixed

• Better checks for copying static assets
• Emulate print for PDF creation in puppeteer

Updated

• Hide menu on PDF export
• Improved styles for PDF export

[2.9.0] - 2024-09-05

Added

• Add support for GTFS-Realtime

Updated

• Reorganize template formatting functions
• Rename agency_key to agencyKey

[2.8.1] - 2024-08-30

Updated

• Updates to demo app

[2.8.0] - 2024-08-30

Updated

• Convert to Typescript
• Dependency updates

[2.7.2] - 2024-08-16

Updated

• Updated docker to node 20
• Dependency updates

[2.7.1] - 2024-08-13

Fixed

• Handle MultiLineString geojson

Updated

• Warning about invalid timetable start/end dates
• Deduplicate timetablePage agency_ids
• Don't show drop_off_type info for first stoptime of a trip, don't show pickup_type info for last stoptime of a trip.
• Dependency updates

[2.7.0] - 2024-07-27

Fixed

• Fixes for horizontal orientation labels

Updated

• Better date format documentation
• Better default for timetable_page_label
• Larger map on desktop
• Improved button styles
• Serve static assets from templatePath
• Move static js and css to views/default
• Dependency updates

[2.6.12] - 2024-07-26

Updated

• Dependency updates
• Improved styles for default template

[2.6.11] - 2024-07-24

Updated

• Dependency updates
• Default template timetable styles

Fixed

• Map route_text_color fix

[2.6.10] - 2024-07-15

Updated

• Better date format in timetable comment
• favicon
• Improved timetable_page_name fallback
• Overview template formatting
• Update mapbox version

[2.6.9] - 2024-07-11

Added

• Stop popup window on map link to streetview

Updated

• Dependency updates

[2.6.8] - 2024-06-21

Updated

• Dependency updates
• Improved convertRoutesToTimetablePages function

[2.6.7] - 2024-05-28

Fixed

• Handle config with no agency_key

Updated

• Dependency updates

[2.6.6] - 2024-05-14

Updated

• Improved error formatting
• Text-wrap for timetable notes for trips
• Dependency updates
• Trip label for vertical multi-route timetables

[2.6.5] - 2024-05-11

Updated

• Timetable trip notes on vertical
• Use route_text_color in timetable continuations
• Dependency updates

Fixed

• Handle trips with nostoptimes in overview

[2.6.4] - 2024-04-30

Updated

• Upated Mapbox GL

Added

• startDate and endDate config.json parameters

[2.6.3] - 2024-04-22

Updated

• Add trip headsign to CSV export

[2.6.2] - 2024-04-19

Updated

• Dependency updates
• Update to timetable page sorting

Added

• Markdown support in timetable notes

[2.6.1] - 2024-03-26

Fixed

• Fix for missing stops

Updated

• Dependency updates
• Day List selector label wording
• Updates to timetable map
• Filename format for CSV export files

[2.6.0] - 2024-02-27

Updated

• Improved timetable_page_label for pages with a single timetable
• Better default timetable styles
• Default route_color and route_text_color values
• Better system map layer ordering
• Dependency updates

Added

• showCalendarExceptions configuration option
• Add "timepoint" class to stoptimes

[2.5.9] - 2024-01-24

Updated

• Move stop markers above map labels
• Update to Mapbox GL JS v3
• Dependency updates

Fixed

• Handle routes with no route_short_name in map marker popups

[2.5.8] - 2024-01-02

Fixed

• Improved warning logging

Added

• Handle case where a calendar_date is both included and excluded

Updated

• Dependency updates

[2.5.7] - 2023-11-07

Updated

• Dependency updates
• Docusaurus 3.0 for documentation site

Added

• Add is_timepoint value to each stop

[2.5.6] - 2023-08-23

Updated

• Dependency updates
• Use most common headsign for timetable name

[2.5.5] - 2023-07-18

Updated

• Dependency updates

[2.5.4] - 2023-07-07

Changed

• Use lint-staged instead of pretty-quick

Updated

• Dependency updates

[2.5.3] - 2023-06-06

Updated

• Dependency updates

[2.5.2] - 2023-05-04

Updated

• Dependency updates

[2.5.1] - 2023-03-06

Updated

• Dependency updates
• Optimize duplicateStopsForDifferentArrivalDeparture

[2.5.0] - 2022-12-31

Updated

• Updated to node-gtfs v4
• Dependency updates

[2.4.4] - 2022-12-22

Updated

• Use adjacent duplicate stoptimes as arrival/depart if different times
• Updates to gtfstohtml.com documentation website dependencies
• Dependency updates

[2.4.3] - 2022-11-10

Updated

• Initialize Map with bounds padding
• Omit unneeded fields from geojson
• Remove adjacent stoptimes with the same stop_id
• Dependency updates

[2.4.2] - 2022-07-26

Updated

• Dependency updates

Fixed

• Moved tailwindcss include to header

[2.4.1] - 2022-07-10

Updated

• Update Dockerfile to node 16
• Dependency updates
• Use yoctocolors instead of chalk

[2.4.0] - 2022-06-07

Updated

• Dependency updates
• Add route labels and stops to system map
• Turn off points of interest labels on all maps
• Better map data styles
• Improved system map route and stop highlighting
• Updated to tailwindcss 3

[2.3.5] - 2022-04-26

Updated

• Dependency updates

[2.3.4] - 2022-04-09

Updated

• Remove route info from map geojson
• Dependency updates

[2.3.3] - 2022-01-21

Updated

• Dependency updates

[2.3.2] - 2021-12-28

Updated

• Dependency updates
• Updated docs info on multi-route timetables

[2.3.1] - 2021-11-26

Updated

• Dependency updates
• Better trip names for CSV export

[2.3.0] - 2021-11-05

Added

• Support for exporting timetables in CSV format

Updated

• Update route color swatch styles to support longer names
• Dependency updates

[2.2.1] - 2021-10-17

Added

• Added release-it info to package.json

[2.2.0] - 2021-10-14

• Dependency updates (9adae81)
• Support for showStoptimesForRequestStops config variable (5790d9d)
• Documentation updates (6ba6b13)

[2.1.9] - 2021-10-11

Fixed

• Better warning if directory is not writable

Updated

• Dependency updates

[2.1.8] - 2021-09-30

Fixed

• Add support for custom config in demo app
• Correct argument usage feedback

Updated

• Dependency updates

[2.1.7] - 2021-09-25

Added

• Dockerfile and instructions for using docker

Updated

• Dependency updates

[2.1.6] - 2021-08-21

Changed

• Better command line warnings and progressbar

Updated

• Dependency updates

[2.1.5] - 2021-08-02

Fixed

• Handle timetables with no routes

Updated

• Dependency updates
• Speed up database import

[2.1.4] - 2021-07-18

Fixed

• Show all stops on route maps

Updated

• Dependency updates

[2.1.3] - 2021-07-14

Fixed

• Copy js to zipped output

Updated

• Dependency updates

[2.1.2] - 2021-07-09

Changed

• Hide timetable service_notes div if empty
• Fall back to "beginning" sorting algorithm if no common stop

[2.1.1] - 2021-07-09

Fixed

• Fix for showRouteTitle config

[2.1.0] - 2021-07-08

Changed

• Improved trip sorting algorithm

Updated

• Updated documentation on trip sorting options
• Dependency updates

[2.0.4] - 2021-06-23

Fixed

• Filtering stops used when start_time/end_time filters for timetables are present
• Geojson generation for timetables when start_time/end_time filters for timetables are present

Updated

• Dependency updates

[2.0.3] - 2021-06-18

Fixed

• noHead config option

Updated

• Dependency updates

[2.0.2] - 2021-06-15

Updated

• Dependency updates
• Use eslint instead of xo

[2.0.1] - 2021-05-15

Fixed

• Fix for default template path
• Fix for copying css/js folders

Updated

• Documentation updates
• Dependency updates

[2.0.0] - 2021-05-13

Breaking Changes

• Converted to ES6 Module

[1.4.16] - 2021-05-07

Changed

• Move directionNames logic to template

Updated

• Dependency updates
• Updates README.md

[1.4.15] - 2021-04-20

Updated

• Better error logging
• Readme updates
• Dependency updates

[1.4.14] - 2021-03-24

Updated

• Filter out trips with < 2 stoptimes
• Dependency updates

[1.4.13] - 2021-03-17

Updated

• Put route lines below street name labels on all maps
• Updated demo app library versions
• Dependency updates

Fixed

• Fix for timepoint determination function

[1.4.12] - 2021-03-02

Updated

• Dependency updates (pug security update)

[1.4.11] - 2021-02-17

Fixed

• zipOutput fix

Updated

• Dependency updates

[1.4.10] - 2021-02-02

Updated

• Dependency updates
• Documentation improvements

[1.4.9] - 2020-12-31

Updated

• Optimize convertRoutesToTimetablePages
• Dependency updates

Fixed

• Fix to handle GTFS with over 1000 calendars

[1.4.8] - 2020-12-21

Updated

• Better error messages
• Dependency updates

[1.4.7] - 2020-12-18

Updated

• Better map stop styles
• Better route short name circles

Fixed

• Use correct color on map for multi-route timetables

[1.4.6] - 2020-12-13

Updated

• Better default GTFS in sample
• Improvements to timetable map popups

Fixed

• Hide progress bar when verbose = false
• Detect TTY and use \n if not

[1.4.5] - 2020-12-09

Updated

• Mapbox GL 2.0
• Timetable map style improvements
• Better timetablepage default name
• Change path to default template

Fixed

• Don't copy static assets if noHead=true
• Handle routes with no agency_id

[1.4.4] - 2020-12-08

Updated

• Improved route and overview maps

[1.4.3] - 2020-12-07

Added

• Add debug config option for profiling database queries

Changed

• Work on optimizing database queries

[1.4.2] - 2020-12-03

Updated

• Group routes by agency on overview page

[1.4.1] - 2020-11-27

Updated

• Support for importing multiple GTFS files at a time.

[1.4.0] - 2020-11-19

Fixed

• Better sort order for timetable_pages

Updated

• Switch to tailwindcss for default template styling.
• Simplify site styles and js CDN includes

[1.3.2] - 2020-11-18

Updated

• Dependency updates

Fixed

• Fix for duplicate stops on loop trips

[1.3.1] - 2020-11-11

Updated

• Documentation

Fixed

• Timetable generation with no timetables.txt and no calendar_dates.txt

[1.3.0] - 2020-11-10

Added

• Timetable notes

[1.2.2] - 2020-11-10

Updated

• Link symbols to notes
• Updated readme

Fixed

• Fix for generation without timetables.txt

[1.2.1] - 2020-10-30

Fixed

• Fix for trips with null direction

[1.2.0] - 2020-10-30

Added

• allowEmptyTimetables config option

Updated

• Improved warning output
• Dependency updates

[1.1.1] - 2020-10-22

Updated

• Reorganized template functions

Fixed

• Better geojson simplification
• Fix for finding common stop id

[1.1.0] - 2020-10-17

Added

• Use directed graph topology sort to determine stop order by default

Fixed

• Default route color on maps

[1.0.12] - 2020-10-14

Updated

• Improved warning output
• Dependency updates

[1.0.11] - 2020-10-13

Added

• Support for extended GTFS route types

[1.0.10] - 2020-10-13

Updated

• Dependency updates
• Better error logging

[1.0.9] - 2020-10-02

Fixed

• Fix for frequencies

[1.0.8] - 2020-09-28

Fixed

• Fixes for time of day timetable filters
• Removed unused template files

Updated

• Updated bootstrap version used in template
• Dependency updates
• Documentation updates

[1.0.7] - 2020-09-14

Fixed

• Fixes for overview page null vs undefined

Updated

• Better error for invalid stop_id
• Dependency updates

[1.0.6] - 2020-09-13

Fixed

• Fixed truncated text on progress bar
• Fixes for timetable generation without timetables.txt files

[1.0.5] - 2020-09-12

Fixed

• Filter out invalid characters from html ids

Updated

• Cleanup timetable map and system map js

[1.0.4] - 2020-09-12

Fixed

• Fix for showOnlyTimepoint filter

[1.0.3] - 2020-09-09

Fixed

• Fix for timetable_sequence sorting

[1.0.2] - 2020-09-06

Fixed

• Fix for route_short_name for multiroute timetables

Changed

• Updated config sample sqlitePath
• Dependency updates

[1.0.1] - 2020-08-23

Changed

• Improvements to geoJSON creation

[1.0.0] - 2020-08-20

Changed

• Use node-gtfs 2.0.0 with SQLite
• Remove mongoDB
• Documentation updates
• Map style improvements

[0.21.1] - 2020-08-14

Changed

• Show route short name for multiroute timetables
• Menu padding in default template
• Always show stop times for stops with pickup_type or drop_off_type greater than zero

[0.21.0] - 2020-07-28

Added

• Support for start_time and end_time fields in timetables.txt

Fixed

• Documentation improvements

[0.20.1] - 2020-07-15

Added

• Prettier error handling
• Documentation website
• Documentation improvements

Fixed

• Correct output path for zip files
• Warning info

[0.20.0] - 2020-06-20

Added

• Added support for timetables that include more than one route.

[0.19.1] - 2020-06-04

Changed

• Use turf.js for geojson simplification.

[0.19.0] - 2020-05-01

Added

• Added support for useParentStation config variable.

[0.18.1] - 2019-09-25

Fixed

• Fixed paths when running as installed gtfs-to-html command

[0.18.0] - 2019-09-25

Added

• PDF export support using outputFormat config option

[0.17.9] - 2019-08-12

Updated

• Handle GTFS with no calendars.txt

Fixed

• Logging when running in app mode
• GTFS with no timetablepages

[0.17.8] - 2019-08-09

Updated

• node-gtfs library
• dependencies and node version

[0.17.7] - 2019-08-06

Added

• dataExpireAfterSeconds config option

Fixed

• Hide summarty table if using custom logging function

[0.17.6] - 2019-08-06

Added

• Config option for custom logging function

[0.17.5] - 2019-07-19

Added

• Support for showStopCity in vertical orientation timetables.

[0.17.4] - 2019-07-11

Added

• Support HTML in formatted_time config

Fixed

• Capitalize days of the week by default
• Don't require a direction_id field to exist in trips.txt

[0.17.3] - 2019-06-07

Changed

• Updates to mongo connection code

Fixed

• Handle timetables with no matching calendars

[0.17.2] - 2019-05-20

Added

• Add GTFS-to-HTML version to log.txt
• Add version and date to timetable HTML as comment

Changed

• Use config defaults when running as npm module
• Style improvements for views without maps

Fixed

• fix for convertRouteToTimetablePage
• fix for log output

[0.17.1] - 2019-05-17

Changed

• Update .gitignore

[0.17.0] - 2019-05-17

Added

• More sorting algorithms (sortingAlgorithm config variable)
• Both arrival and departure shown if difference specified (showArrivalOnDifference config variable)
• Default timetable orientation (defaultOrientation config variable)
• Configurable day strings (daysStrings and daysShortStrings config variables)
• Configurable date and time formatting (dateFormat and timeFormat config variables)

[0.16.3] - 2019-04-09

Changed

• Updated node-gtfs library to 1.8.5 to avoid query timeout on long imports

[0.16.2] - 2019-03-12

Changed

• Added support for "Continues From" trips.
• Improvements to "Continues As" logic.
• Changed config option show_continues_as to show_trip_continuation.

[0.16.1] - 2019-03-07

Changed

• Added ability to hide specific symbols, such as requestDropoffSymbol by setting value to null.
• Better color swatch use on route labels

[0.16.0] - 2019-03-01

Changed

• Added automatic support for showing stops with different arrival and departure times as two separate stops.

[0.15.1] - 2019-02-28

Added

• Changelog

Changed

• Updated dependencies to fix issue with geojson consolidation