OneBusAway for Android User Guide

Thank you for using OneBusAway! We hope that it helps you get around Seattle’s buses quicker and easier. This is a basic guide to using OneBusAway for Android and an introduction to its features.

Using the map

Once OneBusAway launches, you can easily find nearby stops using the map. The map will try to get our current position and automatically center on it, and get the stops near you. You can pan the map and it will update the stops on the map as you pan.

Each stop on the map will be displayed with a pin:

You can tap on this pin to select the stop.

Selecting stops

Once a stop is selected, it will turn from blue to yellow, and a popup will appear to tell you the stop’s name and direction.

You can use your phone’s keypad or trackball to move between nearby stops, or tap once again to go to the arrivals for that stop.

You can also tap on the Show arrivals link to go to the stop’s arrivals, or on Show routes to show a list of route numbers that service this stop.


From the map’s Options menu, you can view your favorite stops, or your favorite routes, including searching for routes and stops.

Using the arrival information

The arrivals screen will display the real-time arrival information for buses at any given stop. It’s a list with entries that look like this:

  • On the left is the route number.
  • In the center:
    • The bus destination (for transit geeks, this is called the headsign).
    • The bus’ predicted arrival time.
    • Whether the bus is early, on time, or delayed, and by how much.
  • On the right, the number of minutes until the bus arrives.
    • If the bus is on time, the color will be bright green.
    • If the bus is late, the color will be blue.
    • If the bus is early, the color will be red.
    • If there is no prediction data available, the color will be dark green.

Clicking on each entry gives you the option of either showing the route’s information¬† or schedule, or setting a reminder.

Adding a star to a stop

You can make a particular stop a favorite by adding a “star” to it from this page. To add a star, you can either tap on the gray star to the left of the stop’s name. The star will turn to yellow , indicating that it’s now a favorite. You can use Add Star from the Options menu. To remove the star, you can either tap on the star again, or use Remove Star on the Option menu.

Changing a stop’s name

You can specify your own easy-to-remember names for stops you use frequently. These names will be shown in the rest of the application where the agency-provided name would have been displayed to make it easier to tell the difference between stops. To change the name, tap on the name of the stop in the header. The header will turn into an edit box:

Type in the name you want for the stop, and tap Save. You can type in Cancel to stop editing, or Clear to go back to the agency-provided name.

Filtering routes

If you’re on a stop with many routes and you only care about one or two, you can filter the list so only the stops you care about are shown. You can filter routes by selecting Filter Routes on the Options menu. In addition, if you only care about one route, tap on any list item for that route, and in the popup box that is shown, tap on Show only this route.

Filters will continue to be set even if you leave the screen. To once again show all routes, tap on the Show all link in the header.

Managing Stops

When on the Map, you can go to the Options menu and tag on My Stops. This screen will have three tabs of information:

  1. Recent. These are the stops you’ve used most recently.
  2. Starred. These are stops you’ve marked as a favorite on the Arrival Info screen.
  3. Search. From here you can search for stops based on its Stop Number.

Finding Stop Numbers

The Stop Number for the bus can be found on the upper left corner of the bus shelter, or on the posted timetable:

If neither are there, you can just find the stop on the map.

The search results will appear in the result list.

Managing routes

When on the Map, you can go to the Options menu and tag on My Routes. This screen will have two tabs of information:

  1. Recent. These are the routes you’ve looked at most recently.
  2. Search. From here you can search for routes based on their number (“10”) or name (“link”).

Using reminders

Do you normally catch the bus at one time and at one stop? Reminders let you schedule your phone to alert you when your bus is approaching.

To set up a reminder, just go to the arrival information of the bus you want to take. You want to make sure that you select the exact bus and exact time you normally take. Click on that bus’ item: you should see the Bus options popup box. Click on Set a reminder.

From the next screen you can give the trip a name, select the time you want an notification, and for the you want it to recur. If you don’t want it to recur, don’t select any days and leave the repeat as “one-time” (this is the default).

Once a reminder is set, you can exit OneBusAway: the notification will appear in your phone’s notification bar.

You can manage your recurring reminders from the Map’s Options menu, using the menu item View Reminders.

Creating shortcuts

If you have a stop or route you use most frequently, you can create links to them from your phone’s Home screen.

To add a shortcut, go to your phone’s Home screen. Using the screen’s Options menu, select Add to get to the Add to Home screen popup. Select Shortcuts and then select either OneBusAway Stop or OneBusAway Route. Clicking on these takes you to either the My Stops or My Routes screens. Clicking on a stop or route will add that to your Home screen as a shortcut.

You can also add shortcuts directly to these screens by using the Recent Stops, Recent Routes, or Starred Stops list items.

Enhancements and bugs

Found a bug? Got an idea to make it better? Please email the developer.

Just like OneBusAway, this User Guide is licensed under the Apache License.

Leave a Reply