API Authentication

The recent user system update introduced an authentication system for users. For the last month, we still allowed write access for unauthenticated users (meaning, users who hadn’t updated the app could still edit maps). But that grace period is over, and we’ve locked down the API.

If you are using the API for a tool/website, and you just lost write access, please contact us to obtain an auth token. If you’re using the app and things seem weird, update the app! The iOS version will give you a detailed error message about the problem, but the Android app will not. We also updated the “Message of the Day” on a lot of regions to try and spread the word. Fortunately, we can see that the vast majority of edits are made by authenticated users, so this should only affect a few people.

Thank you for your generous donations!! As noted earlier, we recently started accepting donations to help us cover infrastructure costs. To date, we’ve received ten donations, covering over half a year’s costs!

Shout out! Thank you:

- William B.
- Matthew C.
- Jason C.
- Stephen H.
- Julie A.
- Tyler D.
- Jukka A.
- John K.
- Erin K.
- Amy C.

If you want to help out, here’s the link!

Side note
We’ve noticed that some people mess up when entering their email address (when they sign up). This makes it so you can’t confirm your account. In some cases (…@gmail.con), we’ve noticed and corrected the problem. But sometimes we don’t know what the problem is – except that the email wasn’t delivered. So! Let us know if you need your email fixed.

Similarly, if you want a new username, let us know.

Pinball Map iOS App Version 4.0.1

Thanks for updating the Pinball Map! It’s been cool watching people sign up!

We’ve released version 4.0.1 of the iOS app!

This update includes:

  • Sort by Operator
  • Location details will display Operator name (and you can add/change the operator)
  • Events page now has three tabs: Today, Upcoming, Ongoing
  • Location detail now displays the most recent machine comment (years ago we accidentally removed this from the app, and you were outraged, so we added it back in immediately; THEN we accidentally removed it again with the 4.0.0 update. So now it’s back again).
  • Region Info displays the correct number of locations and machines in the region
  • Fixed the app feedback form

Keep up with upcoming releases via the issue tracker

Misc Notes

Clarification on users (even though no one asked this):

  • In some contexts you can view other people’s Profiles (you can on the website, but not on the app).
  • User contact information is never shared. Unlike many sites, you can’t send private messages to each other.

Note to API users: If you’re WRITING through the API, please get in touch because you’re about to lose write access. We’ll have to give you an auth token.

App Updates - User System

We just released updates to the app to complement the recent website update. These updates have been in the works since last Spring!

We’ve listed the changelogs below. The user system is the biggest change. Once you create an account, you’ll be set. You won’t have to log in/out. You’ll always be logged in, and you won’t notice anything different… except a bunch of new features! With the user system comes a neat Profile page, where you can see an overview of your updates (screenshots below). We also fixed lots of bugs and added a swath of new features. New features include additional ways to look for machines (sort by operator or city). The Android app received a much-needed facelift. See the full lists below.

Hope you like it! We’re really excited about this update. They mark a big change for Pinball Map. And we think it will be for the better. Thanks for keeping your local pinball map up to date!

iOS app

profile imageprofile image

Check out screenshots on the app store.

Here’s a changelog of the things we added to the iOS app:

* User system
* Profile Page
* Sort locations by operator
* Store page
* High scores for a machine sort by score
* “Recently Updated” section lists 25 updates instead of 10, and includes the date
* Misc things
* Bug fixes

Github page for PBM-iOS

Android app

profile image
profile image

Check out screenshots on the play store.

Here’s a changelog of the things we added to the Android app:

* User system
* Profile page
* Enter high scores
* Lookup by operator
* Lookup by city
* Donate page
* Store page
* Include distance on Location Detail page
* New icon
* Style update
* Misc things
* Bug fixes

Github page for PBM-Android

Website Update - User System

Big Update: Pinball Map User System

We’re very excited to announce that we’ve added a user system to the site! This is something we’ve talked about implementing since very early on. And after nine years of chatting and over a year of developing, we’ve finally done it!

Now you can track your map contributions! Usernames are automatically attached to comments, high scores, and the like. Basically, if you edit a location, the location detail will note, in some form, that you made that edit. There are other little things, too: like, if you contact your regional admin you won’t have to input your name/email.

You can see an overview of your contributions on your Profile page. The Profile page displays:

  • # of machines added to locations
  • # of machines removed from locations
  • # machine comments written
  • # of new locations you’ve submitted
  • # Locations edited
  • List of the locations you’ve edited (with links to them)
  • All your high scores

profile image

In the future, we’ll add more user-based features. But we think this is a great start. We’ve started a list of future ideas here. Some ideas include a points system, favoriting locations, and rankings of each region’s top contributors. If you have ideas, please leave them on that page, or comment here.

With this user system, the site/app is read-only for non-logged in users. When you log in, you can then add/remove machines to/from locations, leave comments, leave high scores, submit locations, etc.

To create an account, go here.

We hope you like it!!

The update for the Android and iOS apps will come out this weekend. Thanks for your patience.

How the user system benefits our admins

In the past we had very little control over abusive behavior. This was by design: 1) the site is designed to be very simple, with very few hurdles to jump; 2) we knew that people who love pinball are generally really NICE! Being nice, and given that the site exists as a helpful tool, we were hopeful that people wouldn’t mess with the data. By and large, this has been very true. We put a lot of power in your hands, and in the 9 years we’ve been doing this there has been just a handful of abuse. But when it does happen, we have very little control over it. So, with this new system each action is tied to a user that we can contact or ban.

Donate to Pinball Map

Another first for us: we added a donate page. We don’t have ads on the site, and the apps are free. In the past there were low costs to operate everything. But those costs have risen as the site has grown. So, rather than include ads to help us pay the infrastructure costs, we’re soliciting donations.

Here are the costs, and thus our annual donation goals:

  • $110/year – Dreamhost
  • $20/year – Domain
  • $192/year – Database + SSL Encryption
  • $100/year – Apple Developer Fee
  • GRAND TOTAL: $422

To donate, click on the paypal button, or visit our Donate page. Thank you!!!

Update Overview

We began working on this update over a year ago. During this process we knocked out lots of bugs, tweaked things, added new features, and redesigned the entire website. On the website alone (e.g. not including the android and iOS apps) we committed code more than 450 times! So, what follows is a brief overview of the updates that we’ve unleashed this week. We might be forgetting some things.

If you find a bug or something, please let us know!

Website Changes

  • Added profile pages, and all the user-based stuff
  • Redesign. The brown color scheme with the hard to read text is totally kaput. In its place we’ve designed a clean, light theme. We hope you like it! The bones of the layout are still pretty similar – this redesign is mostly a new set of clothes. But we focused hard on getting every little detail to look nice. We tightened up the mobile site, too. It can be tough to design sites for all the different devices out there, so if you see anything that looks wack, let us know.
  • SSL. For secure logins and all.
  • Added a “Night Mode” option for the map display. If viewing the site from a mobile browser, this is enabled by default at night (but you can toggle it off). Just like google maps. It’s not enabled by default at night on a desktop browser, but you can toggle it ON!
  • Added a bookmark for searches. Say you search for all the machines for an operator, or in a city, or in a Zone, or all the machines at pizza places – now you’ll see a little link hovering over the corner of the map, called, “Link to this Search Result”. If you copy that, it’s a direct link to that search you just conducted. So you can easily share that link with people, or just bookmark it so you can quickly bring up those results.
  • Added some new, user-related items to the FAQ

For a more nerdly look at the code, you can see all the issues we’ve recently closed.

This is a big update, though we tried to keep this post pretty simple. If you want any more details about any of this, leave a comment!

Pinball Map iOS App Updated to 3.2

Oh what a day! A new Pinball Map iOS app update has hit the streets.

It’s a modest, yet important, release. Modest because it mostly adds some functionality that was already on the website. And important because 1) those functions are cool! and 2) it marks the end of programmer extraordinaire Frank Michael’s involvement in the project. If we had it our way, FM would still be ‘gramming with us. But FM has this thing called “free will” and he’s walking a different walk these days. He stuck around to complete this latest update, and for that we’re very grateful. Reminder, Frank Michael burst into our lives in 2014 and completely revamped the iOS app from the ground up. This the FOURTH app update of his. He played an important role in the app these last couple years, and now we wish him good fortune in his future endeavors.

Here’s the changelog for the 3.2 release:

[New] View PinTips for Machines
pintips.net is a great site for quickly grabbing some machine tips (and for easily contributing your own). We’re glad to be synced up with it.

[New] Show past Machine Conditions
We keep a record of comments made on machines. Previously, you could only see the most recent one. But now you can view past one’s, too!

[New] Show the last time a Location was updated
Is the data for this location two years old, or was it updated yesterday? The answer to this question is now at your fingertips.

[New] Ability to confirm the information for a given Location is up-to-date
Say the location data hasn’t been updated in two years, and yet it’s still up to date! If there’s no data to update, but you’d like to tell the world that you’ve verified the data, now you can with a click of a button.

[New] Filter Nearby Map based on a set of distances (From 10-50 miles
from your current location)

[Fix] Update list of Regions when main site is updated
[Fix] Minor UI Issue where Machine names would not be formatted correctly

Pinball Map Partners with Stern

If you’ve visited the Stern Pinball website in the last few days, you’ll surely have noticed a giant Pinball Map logo in the homepage slideshow. We’re excited to announce that we’ve formed a partnership with Stern Pinball!

Put simply, Stern thinks Pinball Map has the best maintained data, and when people ask, “where can I play your machines?” they point to us.

A key component to sharing the love of pinball is playing them on location. Location pinball reaches more eyes, and tends to be more social. So knowing how to find public pinball is really important. We try to make it as simple as possible to find machines, and we’re happy that Stern (AND all of our users) thinks our site is succeeding.

It’s a mutually-beneficial relationship. Stern is by far the largest pinball manufacturer, and they have a robust social media presence. The more folks they drive to our site, the more up to date our site is. And the data on our site gives Stern an idea of where people are playing and where pinball is growing.

(And for full clarity: this isn’t a sponsorship (we’re not making any money); pinballmap.com is not beholden to Stern.)

As a related aside, we just played Ghostbusters LE the other day, and holy crap is that game fun. So many cool shots packed in there. Stern is at the top of their game right now!

Frequently Asked Questions

We added an FAQ to the site!

We don’t get a lot of questions, but we do get a fair amount of statements. For example, “There are no more machines at this location.” We’re including these statements in the FAQ, and to make them look like questions we added question marks at the ends (that’s how you make something a question, right?). At the moment the FAQ link is tucked away in the menu within a regional map. But we’ll add the link to the homepage soon, too.

At this point, the topics cover:

- Criteria for adding new regions
- Role of administrators

And more.

If YOU have a question, feel free to ask it.

Roanoke, Tucson, Bend

Hey. HEY!

We added three new regions recently:

Roanoke, Virginia

Tucson, Arizona

Bend, Oregon


The Bend locations haven’t been added yet, but will be soon. They have a nice growing pinball scene there.

If you live in any of these areas and know of locations that aren’t listed, please submit those locations! Roanoke’s gotta have more than three locations, right? We want them ALL listed!

Updated Criteria for Creating New Pinball Maps

As much as we want to consider this site to represent anarchism in motion – with anonymous, equal users contributing bits of knowledge – there is a hierarchy of roles. Scott and Ryan are gatekeepers, allowing or denying the creation of new regions. And admins are sub-gatekeepers, allowing or denying the creation of new locations. This made us think: What if we (scott and ryan) are a weak link in this process. We don’t think we are… but still, it made us wonder for a minute there.

People regularly email us asking for a new region. Some of these requests don’t go anywhere. They usually don’t go anywhere because 1) the requests don’t say anything about wanting to administer the data for that region (and they don’t respond when we ask them about that), 2) the region only contains one or two locations, and/or 3) the request is made by an operator.

So, in an attempt to codify this, we’ll elaborate a bit on those three points. They are necessary points when creating a new map.

1) Each map must have a local person acting as an administrator. The administrator must care about the integrity of the map! They’re an overseer. It doesn’t take much work to be an admin. But a good admin is the difference between a languishing, sloppy map and a maintained, clean one. And regular users get a lot more out of a well-maintained map.

So if you request a map, but don’t want to be the admin, then you don’t get a map.

Fun fact: right now the site has 73 regions and over 90 admins.

We’re often looking for NEW admins. If you want to help maintain your local map, hit us up. It never hurts to have more.

2) When areas just have a couple locations with pinball, the maps usually don’t see much action. Ideally, a new region will have 10 (ten) or more locations. But of course, this isn’t always the case. However, we’re going to try and stick to this. The more locations an area has, the more active the map. It’s really cool that your area has one giant arcade with 40 machines. But do you need a map for that?

3) Admins can’t be operators. We’ve had a couple bad experiences lately with admins who are operators failing to remain neutral. In one case, we deleted the region because the guy only added his own places (and did a terrible job with the data entry) and ignored all other location submissions, and in the other case that admin resigned because he steadfastly refused to add his competitors locations (followed shortly by that region experiencing the most malicious edits that we’ve seen in nine years of doing this).

There is a major difference between operators and all the other people who use the maps: operators are in it to make money. It’s their business. And that’s great – part of the mission of this site is to promote pinball, and operators are at the foundation of this. They put machines on route. This map doesn’t exist without them. For everyone else (including us) it’s purely for pleasure. But since operators have a financial stake in contents of the site, they sometimes take it really seriously and personally. For example, to one operator, a “right flipper broken” machine comment might be responded to in the comments with, “oh, thanks, I’ve fixed the flipper.” And another operator might respond to that with, “A++ Machine, Brand New LED. Plays Perfectly, You Gotta Come Down Here And Check It Out!!!” Did this latter operator fix the issue? Not sure. What is more clear is that the comment resembles an advertisement.

It’s flattering to us that operators think this website impacts their business. We want to help them and encourage them to maintain their machines. But… bottom line, they can’t be admins.

Regional Map Model Poll Results

We had a poll to see if people want ONE GIANT MAP or to keep our current regional model. The feedback was great! And here are the results:

36 people voted. Well, 33 of them voted, and 3 of them skipped voting and just left a comment on the poll (which is different than leaving a comment on the blog post).

15 (45.45%) voted for regional maps.
18 (54.55%) voted for one giant map.

And some, in comments, wanted both. Some also wanted the regional maps to be broken up by state.

What does this all mean? Well, it means we’re still discussing things. One giant map is intriguing. Having both is also intriguing. We’ll keep you posted! But for now we thought we’d share the poll results. Interesting how it’s close to a split, don’t you think? But that doesn’t make our jobs easier!

Pinball NYC Locator

Here’s a cool example of a third-party site using our data. Pinball NYC’s locator pulls all of the data from the New York City Pinball Map and reskins it on their site so that league members can find places to play. Kris, the founder of Pinball NYC, is also our admin for the NYC map. He just released a big to the league’s site, and added in this feature as part of it.

Their league formula can be used in any city! So contact him if you’re into it.

Operators: We Want You

Do you operate machines that are listed on pinballmap.com?

When something’s wrong with one of your machines, do you want to know about it so you can fix it ASAP?

If you answered YES to those questions, then read on.

For all your locations, we can “tag” you as the operator. Then, you can “search by operator” for yourself, and pull up all your locations. From there you can quickly update the locations (add/remove machines) and see if anyone has left comments about the conditions of your machines. Pretty handy, right?

But wait! There’s more: If you choose to provide us with your email address, then we’ll automatically send you a daily email that contains all the comments left on your machines. This is a simple way to see what problems people are reporting (and note to sensitive operators: most of the comments people leave are about problems, so don’t let them hurt your feelings). Then you can fix them, and then leave a new comment that says, “Fixed!”

If no one leaves a comment on one of your machines, then you won’t get an email that day. If you decide you don’t want to receive them anymore, just tell us.

What do we want from you?

If you want your locations tagged with you, then we’ll need your business name and a list of your locations.

If you also want to receive the daily digest of comments, then please include your email address.

How do you send that to us?

You can send it directly to the administrator of whichever region your machines are in. For example, if your machines are in the Grand Rapids region, you’d use the contact form on the Grand Rapids Pinball Map.

Or you can send it to the uber administrators, Scott and Ryan, using the Portland Pinball Map contact form.

We added this feature as a service to you. We hope it makes your life easier, and your customers happier. Thanks!

New England Pinball Maps

The Boston Pinball Map was a big map. How big was it, you ask? It covered a good portion of New England.

But if you live in Connecticut, would you know to look under the Boston map in order to locate pinball machines in your area? Probably not. So, in order to make the regional maps in that area more intuitive for people, we split them up in state regions. So now instead of a Boston map we have:

Massachusetts Pinball Map
Connecticut Pinball Map
Rhode Island Pinball Map
New Hampshire Pinball Map

We didn’t create Vermont or Maine, because there are already two city-based maps in them:

Burlington, Vermont Pinball Map
Portland, Maine Pinball Map

We’re looking for administrators for Connecticut, Rhode Island, and New Hampshire! If you live in those states, love pinball, and enjoy punctuating things correctly and helping keep data clean, then please contact us.

Update Location Metadata - Show Closest Locations

New website features:

1) Users can now edit some location metadata fields:

- Operator
- Location Type
- Phone Number
- Website

To edit them, lookup a location then click “click to update location metadata”.

Both Operator and Location Type are from dropdowns. So if you want to assign an operator that isn’t currently listed, then you should use the contact form and request to have that op added.

The Website field currently only accepts values that start with http:// – But we’ll soon have it also accepting https://

The Phone Number field only accepts this format: 000-000-0000. And we haven’t added error messages yet! So, if you type in (000) 000-0000 you’ll be silently rejected.

2) Regional maps now include a “Show Closest Locations” button! When clicked, it will display all locations within a 5 mile radius.

This button is in the header.

The results even show how far each spot is from you!

We’ll be adding in more geolocation-based features to the website soon.

Location Timestamps

A lil’ ditty ’bout location timestamps.

Ever wondered when a location was last updated? Like, is the machine list possibly old and stale? Or is it new and fresh? Well wonder no more! Now each location has a timestamp that shows when it was last updated. The timestamp is automatically updated when machines are added/removed from the location, and when machine comments are made.

There’s also a button so that you can click with either your mouse or your finger (if you’re on a touchscreen) to confirm that the machine list is up to date. So, even if you don’t have an update to make, but you know the machine list is current, then you can click it and feel good about your good self.

We’ll roll out this feature to the app in a bit. For now it’s just on the web. And if a location hasn’t been updated since we added this to the website, then the timestamp isn’t there.

Here’s an example of it in action: Bierstube on the Twin Cities Pinball Map was last updated on October 8, 2015.

Take care, everyone.