Skip to content

Stand alone tool to annotate/label bounding box on images

License

Notifications You must be signed in to change notification settings

chrisvoncsefalvay/BBTag

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BBTag

bbtag

BBTag is meant to be used for tagging (i-e labeling rectangles) images, which is a tedious task for people who need to make their own dataset for supervised machine learning. In a nutshell, the advantages of BBTag are:

  • multiple labeling: each image can be tagged multiple times with different labels.
  • label organization: a BBTag session is grouped by label. It becomes very easy to know which labels are present in each image without having to view the images one by one. An "Untagged" section is also provided by default to quickly find out which images need to be tagged.
  • worry-free tagging: add and remove tags as needed. If you got a tag wrong, delete it and tag again without impacting any other tag.
  • selective saving: save your entire BBTag session or just a subset based on image and/or labels. You can reuse the same pool of images for different purposes (e.g. save only "faces" and "body", then "person", etc. regardless of the overlap between each tag).
  • XML or image part output: save your dataset as
    • XML file: it will containing the path to images and label bounding box coordinates. This file can be directly input in dlib for instance. You may also read the data with python and appropriate XML package.
    • Image part files: it will output one folder per label. Each label folder will contain the image part cropped by the bounding boxes for that label. It could be useful for direct input to train Deep Learning networks for instance.

BBTag_preview

Installation

  • Either download binaries from v1.1 release available for MacOSX, Windows 64-bits and Ubuntu 15
  • Or build it from source:
    1. download the source code: git clone https://github.com/clavicule/BBTag.git
    2. download and install Qt 5.x (originally built and tested against Qt 5.5)
    3. build BBTag:
    • either run qmake BBTag.pro then make (or equivalent depending on your platform)
    • or load BBTag.pro in Qt Creator and go to Build > Build Project "BBTag"

Improvements

Please, don't hesitate to report any issue or enhancements requests.

About

Stand alone tool to annotate/label bounding box on images

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 85.1%
  • HTML 14.1%
  • QMake 0.8%