Getting Started

1. Click "Load Dataset Folder" to select a folder containing your images (.jpg, .png) and XML annotation files.

2. The tool will automatically pair images with their corresponding XML files by matching filenames.

3. Use the sidebar to navigate through your images. Click on any image thumbnail to view it.

Working with Bounding Boxes

Viewing Boxes: Bounding boxes from XML files are automatically displayed on images.

Selecting Boxes: Click on any bounding box to select it. Selected boxes show resize handles.

Moving Boxes: Click and drag a selected box to move it.

Resizing Boxes: Drag the corner handles of a selected box to resize it.

Adding Boxes: Click "Add Bounding Box" button or hold Shift and click-drag on the canvas.

Deleting Boxes: Select a box and press Delete or click the trash icon in the annotation panel.

XML Mapping Configuration

If your XML files use different tag names than standard Pascal VOC format:

1. Go to the "XML Mapping" tab

2. Configure which XML tags correspond to: label, xmin, ymin, xmax, ymax

3. Select coordinate type: Absolute, Normalized (0-1), or Width/Height

4. Click "Apply Mapping" to re-parse all XML files with the new settings

Class Management

Global Classes: All classes detected in your dataset are listed in the "Classes" tab.

Adding Classes: Enter a class name and click "Add Class" to add it to the global list.

Managing Classes for Current Image:

• Select a class from the dropdown
• Enter a new name and click "Rename" to rename the class
• Click "Delete" to remove the class
• Choose whether to apply changes to "Current image only" or "All images in dataset"

Keyboard Shortcuts

• A or ← - Previous image
• D or → - Next image
• Delete - Delete selected bounding box
• Ctrl + S - Save changes
• Shift + Click-Drag - Draw new bounding box
• Mouse Wheel - Zoom in/out
• Click-Drag (without Shift) - Pan around zoomed image

Saving & Exporting

Save Changes: Click the Save button to either overwrite original files or export as ZIP.

Export Formats: You can export your dataset in different formats:

• YOLO Format: Creates .txt files with normalized coordinates
• JSON Format: Creates a single JSON file with all annotations
• ZIP Export: Creates a ZIP with updated XML files and images

Image Management

Multi-Select: Click "Select Multiple" to select multiple images for batch operations.

Deleting Images: Select images and click "Delete Selected" to remove them from the dataset.

Navigation: Use Previous/Next buttons or keyboard shortcuts to navigate through images.

Privacy & Safety

This tool runs entirely in your browser. No images or annotations are uploaded to any server. All processing happens locally on your computer.