Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vra/easybox

☐ :chart_with_upwards_trend: ☐ A simple, out-of-the-box and cross-platform bbox annotation tool by Python. Try it by `pip install easybox`
https://github.com/vra/easybox

computer-vision deep-learning gui linux object-detection python tkinter

Last synced: 2 months ago
JSON representation

☐ :chart_with_upwards_trend: ☐ A simple, out-of-the-box and cross-platform bbox annotation tool by Python. Try it by `pip install easybox`

Awesome Lists containing this project

README

        

# easybox
A simple but powerful bounding box annotation tool by Python

## Install
### 1. use pip
This works on both Linux and Windows.
```bash
pip3 install --user easybox
```
Then run below command in termial to begin:
```bash
easybox
```

### 2. use release
This method only works on Windows.

Download the execute file from the release page: .
Directly run `*.exe` to begin.

## How to use
### 1. Demo
![demo](./imgs/demo.gif)

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
```bash
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
```bash
git clone https://github.com/vra/easybox
cd easybox
python3 setup.py install --user
```
Then run below command in termial to begin:
```bash
easybox
```

### 2. Windows
Install Pyinstaller first: `pip3 install --user pyinstaller`.

Then run:
```bash
pyinstaller.exe -F -w ./easybox/main.py
```
A execute file named `main.exe` will be created in `dist` folder, you can directly run it.
```bash
./dist/main.exe
```

## Acknowledgement
This project is inspired by [BBox-Label-Tool](https://github.com/puzzledqs/BBox-Label-Tool), many thanks to the author.