Convert annotation formats

How To Convert SuperAnnotate JSON to YOLOv5 PyTorch TXT

In this guide, we show you how to convert data between the Superannotate and YOLOv5 formats for free. You can use your converted data to train YOLO-NAS models and other models that support the YOLOv5 format.

Convert with an AI agent

Paste this prompt into your coding agent

Claude Code, Cursor, Codex or any agent with the Roboflow MCP uploads your SuperAnnotate JSON dataset to Roboflow, generates a version and downloads it as YOLOv5 PyTorch TXT.

No Roboflow MCP yet? The prompt has your agent set it up first, or connect your agent before you paste it.

Rather convert it by hand? Follow the steps below

SuperAnnotate JSON

SuperAnnotate (formerly annotate.online) is a self-service labeling tool and outsourced annotation provider.

Below, learn the structure of SuperAnnotate JSON.

annotations.jsonJSON
{
    "mask.jpg": [{
        "type": "bbox",
        "classId": 1,
        "probability": 100,
        "points": {
            "x1": 67.8,
            "x2": 187.6,
            "y1": 166.6,
            "y2": 274.1
        },
        "groupId": 0,
        "pointLabels": {},
        "locked": false,
        "visible": true,
        "attributes": []
    }, {
        "type": "polyline",
        "classId": 2,
        "probability": 100,
        "points": [148.7, 321.1, 164.5, 328.3, 220.4, 335.5, 280.6, 344.8, 330.1, 341.9, 373.1, 330.5, 375.3, 336.2, 377.4, 369.9, 382.4, 384.9, 377.4, 409.3, 360.2, 425.1, 318.6, 451.6, 279.9, 473.8, 262.7, 488.2, 252, 499.6, 241.9, 502.5, 223.3, 496.8, 210.4, 486, 181.7, 453.8, 165.9, 443, 155.9, 431.5, 148, 419.4, 132.3, 410, 123.7, 397.8, 139.4, 346.2, 151.6, 319.7, 150.9, 321.1],
        "groupId": 0,
        "pointLabels": {},
        "locked": false,
        "visible": true,
        "attributes": []
    }, {
        "type": "polygon",
        "classId": 2,
        "probability": 100,
        "points": [493.7, 355.6, 506.1, 366.1, 567.3, 384.2, 648.5, 352.7, 649.5, 372.8, 659, 386.1, 649.5, 402.4, 631.3, 424.4, 618.9, 451.1, 612.2, 456.9, 585.4, 474.1, 570.1, 477.9, 552, 466.4, 527.1, 454, 491.8, 402.4, 494.6, 377.5, 493.7, 355.6],
        "groupId": 0,
        "pointLabels": {},
        "locked": false,
        "visible": true,
        "attributes": []
    }, {
        "type": "meta",
        "name": "lastAction",
        "timestamp": 1600628979793
    }]
}
classes.jsonJSON
[{
    "attribute_groups": [],
    "color": "#32a852",
    "id": 1,
    "name": "no-mask",
    "opened": true
}, {
    "attribute_groups": [],
    "color": "#d6d619",
    "id": 2,
    "name": "mask",
    "opened": true
}]

YOLOv5 PyTorch TXT

A modified version of YOLO Darknet annotations that adds a YAML file for model config.

Below, learn the structure of YOLOv5 PyTorch TXT.

Each image has one txt file with a single line for each bounding box. The format of each row is

class_id center_x center_y width height

where fields are space delimited, and the coordinates are normalized from zero to one.

Note: To convert to normalized xywh from pixel values, divide x (and width) by the image's width and divide y (and height) by the image's height.

001.txt
1 0.617 0.3594420600858369 0.114 0.17381974248927037
1 0.094 0.38626609442060084 0.156 0.23605150214592274
1 0.295 0.3959227467811159 0.13 0.19527896995708155
1 0.785 0.398068669527897 0.07 0.14377682403433475
1 0.886 0.40879828326180256 0.124 0.18240343347639484
1 0.723 0.398068669527897 0.102 0.1609442060085837
1 0.541 0.35085836909871243 0.094 0.16952789699570817
1 0.428 0.4334763948497854 0.068 0.1072961373390558
1 0.375 0.40236051502145925 0.054 0.1351931330472103
1 0.976 0.3927038626609442 0.044 0.17167381974248927

The `data.yaml` file contains configuration values used by the model to locate images and map class names to class_id's.

data.yaml
train: ../train/images
val: ../valid/images

nc: 3
names: ['head', 'helmet', 'person']

Step 1: Create a free Roboflow account

Roboflow is a universal conversion tool for computer vision annotation formats. To convert your dataset, start by creating a free Roboflow account.

Create free Roboflow account

Step 2: Upload your data into Roboflow

Once your account has been created, click Create New Project. (opens in a new tab)

Roboflow's create project form, with Object Detection selected as the project type

Upload your data to Roboflow by dragging and dropping your SuperAnnotate JSON images and annotations into the upload space.

Roboflow's upload page, with a drag-and-drop area for images, annotations, videos and PDFs

Step 3: Generate Dataset Version

Next, click "Generate New Version" to generate a new version of your dataset:

Roboflow's Generate a Dataset Version page, showing the source images and train/test split for a new version

You can then apply any preprocessing or augmentation steps to your dataset:

The augmentation step of a new dataset version, with 90° Rotate and Brightness added

Step 4: Export Dataset Version

After generating, you will be prompted to Export your dataset. You can choose to receive your dataset as a .zip file or a curl download link. Choose YOLOv5 PyTorch TXT when asked in what format you want to export your data. You will see a dropdown with various options like this:

Roboflow's Download dialog, with the export format list open and COCO highlighted

Congratulations, you have successfully converted your dataset from SuperAnnotate JSON format to YOLOv5 PyTorch TXT format!

Video Tutorial

Convert Computer Vision Annotation Formats Tutorial

Want to dive deeper into converting annotation formats with Roboflow? In the tutorial below, we explore how to convert your data in the Roboflow dashboard. We also discuss rejecting annotations and train-test-validation splits.

Frequently Asked Questions

Yes! It is free to convert SuperAnnotate JSON data into the YOLOv5 PyTorch TXT format on the Roboflow platform.

If you have between a few and a few thousand images, converting data between these formats will be quick. But, the time it takes to convert between data formats increases with the more images you have.

Show guide

Convert SuperAnnotate JSON to other formats

Convert other formats to YOLOv5 PyTorch TXT

Related

Start where you are

Speak with an AI expert

Our team will help you start solving business problems on the first call.

  • Solution architecting
  • Live demonstration
  • Pricing and specifications
  • Feasibility assessment

Over 80,000 organizations build with Roboflow.

Rivian
Pella
Chobani
USG Corporation
BNSF Railway
American Woodmark
Outcomes
Patrick Industries
Peer Robotics
Create free Roboflow account