ubershmekel / bjjdata

Organizing links to clips of submissions

bjjdata

Organizing links to clips of submissions with metadata

Why make another bjj db?

I saw bjjheroes, tapology, drub.co, bjjcollective, and they were all out of date or difficult to browse. It's hard to curate useful data to learn submission details. But when the data is privately held, there is no incentive to contribute. So I thought I'd try and organize an open source collection of bjj data.

The data here is not just mine. It's MIT licensed, so you can copy this repo to make the data yours if you like.

What kind of BJJ data is here?

While I enjoy instructional videos, it's hard to judge if the advice is sound. High level competition results don't lie.

So this repo is focused on curating timestamped YouTube links to submissions in competitions involving world champions.

How to add a clip to this site?

Your contributions are welcome.

1. Look at this example file.

2. Browse to the correct year's folder, for example https://github.com/ubershmekel/bjjdata/tree/main/data/2022

3. Create a new file using the button at the top right.

4. Name the file [first-name-person1]-[first-name-person2]-1.md, add the contents similarly to the example file.

5. Make sure the submission clip time starts just 2-3 seconds before the submission is starting to lock in, so we can see the entry.

6. Make sure the submission clip time ends just 2-3 seconds after the tap, so we can see the tap.

7. Then click "propose new file" and create the pull request.

Criteria for clips

• Clearly see the submission and details

• In a tournament, preferably 2-3 years old or newer

• The match is between a championship winner and at least a championship quarter finalist

How to use the data on your site

You can clone this repo and use the markdown, or just fetch https://ubershmekel.github.io/bjjdata/data.json