https://github.com/puzzledqs/BBox-Label-Tool

A simple tool for labeling object bounding boxes in images
https://github.com/puzzledqs/BBox-Label-Tool

Last synced: 3 months ago
JSON representation

A simple tool for labeling object bounding boxes in images

• Host: GitHub
• URL: https://github.com/puzzledqs/BBox-Label-Tool
• Owner: puzzledqs
• License: mit
• Created: 2014-06-09T14:46:46.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-04-17T17:20:48.000Z (over 4 years ago)
• Last Synced: 2024-06-12T01:52:39.110Z (5 months ago)
• Language: Python
• Homepage:
• Size: 31.4 MB
• Stars: 1,122
• Watchers: 46
• Forks: 566
• Open Issues: 39
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
BBox-Label-Tool

===============

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

**Updates:**

- 2017.5.21 Check out the ```multi-class``` branch for a multi-class version implemented by @jxgu1016

**Screenshot:**

![Label Tool](./screenshot.png)

Data Organization

-----------------

LabelTool  

|  

|--main.py   *# source code for the tool*  

|  

|--Images/   *# direcotry containing the images to be labeled*  

|  

|--Labels/   *# direcotry for the labeling results*  

|  

|--Examples/  *# direcotry for the example bboxes*  

Environment

----------

- python 2.7

- python PIL (Pillow)

Run

-------

$ python main.py

Usage

-----

0. 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**.

1. 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.

2. 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 ``.

  - 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`.

3. 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.

  - Be sure to click `Next` after finishing a image, or the result won't be saved.