Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/darkpgmr/DarkLabel

Video/Image Labeling and Annotation Tool
https://github.com/darkpgmr/DarkLabel

Last synced: about 2 months ago
JSON representation

Video/Image Labeling and Annotation Tool

Awesome Lists containing this project

README 

        
# DarkLabel



### Video/Image Labeling and Annotation Tool

This is a utility program that can label object bounding boxes with ID and name in videos and images. It also can be used to crop videos, sample traninig images in a video, and mosaic image region. Anyone can use it for non-commercial purposes.



※ Since this program is not code-signed, download and execution may be blocked by Windows and web browsers. This is a personally created program and a 100% safe program, but only for those who need it.



### Download Latest Executable

* [DarkLabel2.4](https://github.com/darkpgmr/DarkLabel/releases/download/darklabel-release/DarkLabel2.4.zip)

(currently, only binary executables can be downloaded)



![My image](https://github.com/darkpgmr/DarkLabel/blob/master/image/darklabel_gui.png)



### Main Features

* Video/image object labeling & annotation tool (bounding box with ID and label)

  * automatic object labeling by visual tracking (multi-target)

  * semi-automatic labeling by linear interpolation

  * user-configurable hotkeys and zoom in / zoom out support

  * user-configurable data formats (pascal voc, darket yolo, xml/txt, any other user-defined formats)

* Video splitting (into images) & image merging (into a video file) tool

* Video cropping tool (cut and save only the selected section in the video)

* Video/image privacy masking tool (mosaic the box area in the image)

* Windows only (32/64 bits)



### Program Configuration

The program can be configured by modifying [darklabel.yml](https://github.com/darkpgmr/DarkLabel/blob/master/darklabel.yml) attached in the zipped archive.

* define and modify data formats

* change hotkeys (frame navigation, action keys)

* change video/image export setting (video codec, frame rate, image format)

* set default save/load directory

* define class labels

* adjust GUI drawing (box width, box color, ...)



### Basic Instruction



	Arrow/PgUp/PgDn/Home/End: navigate image frames	

	

	Mouse: Left(create box), Right(cancel the most recently created box)

	Shift+Mouse: Left(modify box), Right(delete selected box/trajectory or all boxes)

	Shift+DoubleClick: modify box properties (label, ID, difficulty)

	

	DoubleClick: select/deselect box trajectory

	*box trajectory: boxes connected across frames with the same ID and label

	

	Ctrl+'+'/'-': zoom in/out

	Ctrl+Arrow: scroll zoomed window

	Ctrl+MouseWheel: zoom in/out

	Ctrl+MouseDrag: scroll zoomed window

	

	Enter or Spacebar: apply tracking (selected trajectories or newly created boxes only)

	Ctrl+'s': save gt	

	F1: show help



### Advanced Instruction

* Labeling by object tracking

  * By pressing 'Return' key, _newly created_ bounding boxes in the current frame are tracked in the next frame and labeled automatically.

    * _newly created boxes_: the boxes that are created after entering into the frame.

  * If there are selected trajectories in the frame (object trajectory can be selected by double clicking a box), only the trajectory boxes are tracked (newly created boxes are not tracked).

  * If tracking is applied to trajectories, it first deletes their tail parts (connected trajectory boxes after the current frame) and then continue the tracking, keeping their IDs and labels. This functionality can be used to correct previous wrong tracking.

  * Two trackers are embeded. (developed by darkpgmr)

    * tracker1 (robust): good for deformable objects (e.g., human, ..)

    * tracker2 (accurate): good for rigid/static object (e.g., vehicle, wall, house, ...)

* Data Sampling/gathering

  * If you want to sample images in a video and save them (e.g. gathering training samples), draw dummy boxes on the images and then export the annotation results as images with the "no box drawing" option selected and the "labeled frames only" checked.

* Privacy Masking

  * draw boxes on the privacy area (e.g. human faces) and then export the annotation results with the "mosaic the box area" option selected.

* Full screen mode

  * do annotation in full screen mode in case the image is too large to show in your monitor (double click the title bar of image window). You also can utilize zoom in functionality.

* Don't forget to save your annotation results as often as possible. You can just press Ctrl+S.