easybox

A simple but powerful bounding box annotation tool by Python


Keywords
easybox, Detection, Python, Deep-learning, TKinter, computer-vision, gui, linux, object-detection
License
MIT
Install
pip install easybox==0.0.5

Documentation

easybox

A simple but powerful bounding box annotation tool by Python

Install

1. use pip

This works on both Linux and Windows.

pip3 install --user easybox

Then run below command in termial to begin:

easybox

2. use release

This method only works on Windows.

Download the execute file from the release page: https://github.com/vra/easybox/releases. Directly run *.exe to begin.

How to use

1. Demo

demo

Firstly you need to choose a folder with images. Then you can begin annotate them using easybox. The annotations will save in the subfolder named easybox. The format of each bbox in annotation file is

top left bottom right color

You can ignore color when further process your annotations.

2. Shortcuts

Operate UI operation Shortcut
Open folder File->Open Ctrl-o
Save annotation Save Button Ctrl-s
Load previous image Previous Button <-, Middle mouse button
Load Next image Next Button ->, Right mouse button
Load Next image Next Button ->, Right mouse button
Delete previous bbox Ctrl-z
Open help window Ctrl-h
Open about window Ctrl-a
Exit File->Exit Ctrl-q

Build from source

1. Linux

git clone https://github.com/vra/easybox
cd easybox
python3 setup.py install --user

Then run below command in termial to begin:

easybox

2. Windows

Install Pyinstaller first: pip3 install --user pyinstaller.

Then run:

pyinstaller.exe -F -w  ./easybox/main.py

A execute file named main.exe will be created in dist folder, you can directly run it.

./dist/main.exe

Acknowledgement

This project is inspired by BBox-Label-Tool, many thanks to the author.