About My Discs

As my disc golf disc collection has grown to become more than I can keep in my head, I decided to make this disc catalog and visualisation web app. It's built after my own needs, showing a stability/speed matrix table with the colors of the discs and attribute statistics, where most things are clickable to view all discs with that characteristic. It's a fun way to rediscover discs you are no longer throwing!

You can use it for your discs too!

Even though I built this for me, you are free to use it as well, as long as you are willing to catalog your disc collection or bag the way I did (and have experience with JSON).

JSON (JavaScript Object Notation) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate.

As I'm not ready for the big responsibility of hosting other people's important disc catalog data, you also need to have a GitHub account and add your data there as a Gist.

Then you can view your own collection like this:

https://discgolf.librarian.dev/your-github-username/your-long-gist-id/

Catalog like this

{
  "locations": ["My bag"],
  "discs": [
    {
      "mold": "Atom",
      "manufacturer": "MVP",
      "plastic": "Electron",
      "plasticVariations": ["Cosmic", "Soft"],
      "numbers": "3 3 0 1",
      "color": "orchid",
      "notes": "This is an optional note",
      "weight": 175,
      "location": 0
    }
  ]
}

If this looks complicated to you, it's probably gonna be too difficult to continue. Sorry.

The JSON object have an array each of locations and discs where the location attribute of the disc points to the index value of the location. I have many locations so I can see in which box I have a certain disc, but you need at least one named location like this.

This is how two locations might look like:

{
  "locations": ["My bag", "Storage box"],
  "discs": [
    {
      "mold": "Atom",
      "manufacturer": "MVP",
      "plastic": "Electron",
      "plasticVariations": ["Cosmic", "Soft"],
      "numbers": "3 3 0 1",
      "color": "orchid",
      "notes": "This is an optional note",
      "weight": 175,
      "location": 0
    },
    {
      "mold": "Buzzz",
      "manufacturer": "Discraft",
      "plastic": "ESP",
      "numbers": "5 4 -1 1",
      "color": "turquoise",
      "weight": null,
      "location": 1
    }
  ]
}

Note how weight and plasticVariations are optional. color can be any hex code color value like #ff0000 for example, but I recommend you use the HTML color names since you will then also be able to see color statistics.

There's also the typeSpeed attribute for disc type classification:

{
  "mold": "Tactic",
  "manufacturer": "Discmania",
  "plastic": "Vapor",
  "numbers": "4 2 0 3",
  "typeSpeed": 3,
  "color": "cornflowerblue",
  "playerAssociations": ["Eagle McMahon"],
  "weight": 174,
  "location": 1
}

The app counts speed 4 to 6 as midranges, so if you want to override that you can provide typeSpeed to make a disc fall into another category. The Discmania Tactic is more of a putter than midrange, so this makes it count as one. Same goes for fairway drivers that are speed 6. They need a typeSpeed of 7 to count as a FD.

You can also add playerAssociations if you want to connect signature discs or signed discs to specific players. They are then enabled for autocomplete in the search box (only notes are available for free text search).

Add as a gist

When you have all your discs in this data format, add them as a gist on GitHub with any file name, but .json file extension. Then you can view them here like this:

https://discgolf.librarian.dev/your-github-username/your-long-gist-id/

Note: Don't forget the trailing slash.