| .github | ||
| .idea | ||
| application | ||
| client | ||
| doc | ||
| gtfs-realtime-protobuf | ||
| otp-shaded | ||
| raptor | ||
| script | ||
| test | ||
| utils | ||
| .git-blame-ignore-revs | ||
| .gitignore | ||
| .prettierrc.yml | ||
| ARCHITECTURE.md | ||
| codecov.yml | ||
| CONTRIBUTING.md | ||
| DEVELOPMENT_DECISION_RECORDS.md | ||
| lgpl-3.0.txt | ||
| LICENSE | ||
| magidoc.mjs | ||
| maven-settings.xml | ||
| mkdocs.yml | ||
| pom.xml | ||
| README.md | ||
| renovate.json5 | ||
Overview
OpenTripPlanner (OTP) is an open source multi-modal trip planner, focusing on travel by scheduled public transportation in combination with bicycling, walking, and mobility services including bike share and ride hailing. Its server component runs on any platform with a Java virtual machine ( including Linux, Mac, and Windows). It exposes GraphQL APIs that can be accessed by various clients including open source Javascript components and native mobile applications. It builds its representation of the transportation network from open data in open standard file formats (primarily GTFS and OpenStreetMap). It applies real-time updates and alerts with immediate visibility to clients, finding itineraries that account for disruptions and service changes.
Note that this branch contains OpenTripPlanner 2, the second major version of OTP, which has been under development since 2018 and is now the dominant one and the only one being supported.
Development
OpenTripPlanner is a collaborative project incorporating code, translation, and documentation from contributors around the world. We welcome new contributions. Further development guidelines can be found in the documentation.
Contributing Guidelines
See CONTRIBUTING.md
Development History
The OpenTripPlanner project was launched by Portland, Oregon's transport agency TriMet (http://trimet.org/) in July of 2009. As of this writing in September 2025, it has been in development for over 16 years. See the main documentation for an overview of OTP history and a list of cities and regions using OTP around the world.
Measuring OTP Performance
We run a speed test (included in the code) to measure the performance for every PR merged into OTP.
More information about how to set up and run it.
Repository Layout
The main Java server code is in application/src/main/. OTP also includes a Javascript client
based on the MapLibre mapping library in client/src/. This client is now used for testing, with
most major deployments building custom clients from reusable components. The Maven build produces a
unified ("shaded") JAR file at otp-shaded/target/otp-shaded-VERSION.jar containing all necessary
code and dependencies to run OpenTripPlanner.
Additional information and instructions are available in the main documentation, including a quick introduction.
Getting in Touch
The fastest way to get help is to use our Gitter chat room where most of the core developers are. Bug reports may be filed via the Github issue tracker. The OpenTripPlanner mailing list is used almost exclusively for project announcements. The mailing list and issue tracker are not intended for support questions or discussions. Please use the chat for this purpose. Other details of project governance can be found in the main documentation.
OTP Ecosystem
- awesome-transit Community list of transit APIs, apps, datasets, research, and software.