BBox-Label-Tool

A simple tool for labeling object bounding boxes in images, implemented with Python Tkinter.

Updates:

2018.11.13 Added python3 compatibility by @rexlow
2018.4.29 Added scrolling to enable working with high-res images by @toobaimt
2017.5.21 Check out the multi-class branch for a multi-class version implemented by @jxgu1016

Screenshot:

Data Organization

$ python3 main.py

Install ImageMagick (only for macOS)

$ brew install imagemagick (if you are using macOS)

Convert old format to jpeg

$ for i in *.JPG ; do convert "$i" "${i%.*}.jpeg" ; done

Convert old format to jpeg and downscale image to 50% (Optional)

$ for i in *.JPG ; do convert "$i" -resize 50% "${i%.*}.jpeg" ; done

The current tool requires that the images to be labeled reside in /Images/001, /Images/002, etc. You will need to modify the code if you want to label images elsewhere.
Input a folder number (e.g, 1, 2, 5...), and click Load. The images in the folder, along with a few example results will be loaded.
To create a new bounding box, left-click to select the first vertex. Moving the mouse to draw a rectangle, and left-click again to select the second vertex.

To cancel the bounding box while drawing, just press <Esc>.
To delete a existing bounding box, select it from the listbox, and click Delete.
To delete all existing bounding boxes in the image, simply click ClearAll.

After finishing one image, click Next to advance. Likewise, click Prev to reverse. Or, input an image id and click Go to navigate to the speficied image.