동영상 또는 이미지에 ID를 가진 물체 경계사각형(bounding box)를 labeling할 수 있는 유틸러티 프로그램입니다. 학습 데이터 생성 외에도 이미지들을 동영상으로 합치거나 분리할 때, 개인정보 보호를 위해 사람 얼굴 등을 모자이크하는 용도로도 활용할 수 있습니다.

This is a utility program that can label object bounding boxes with ID in videos and images. Anyone can use it for non-commercial purposes. If you have any inquiry or suggestion, you can leave message below or email to darkpgmr.lee at gmail dot com.

※ This program is not code-signed and can be blocked by Windows.

DarkLabel 2.0 (2020.07.14)

download executable: DarkLabel2.0.zip (last updated July 14, 2020)

download previous versions: check Version History below

Tutorial Video (https://www.youtube.com/watch?v=lok30aIZgUw)

old demo1(gt_extractor): https://www.youtube.com/watch?v=zFpX2bORz5E

old demo2(darklabel1.2): https://www.youtube.com/watch?v=vbydG78Al8s

Main Features (주요 기능 및 특징)

• bounding box labeling of video & image objects
• support predefined data formats (pascal_voc/imagenet, darknet yolo)
• support user-defined data formats (formats can be defined in 'darklabel.yml')
• automatic box labeling by visual tracking
• semi-automatic labeling by linear interpolation
• user-defined hotkeys and zoom in / zoom out support
• export annotation result as videos or images (it can be used to split a video file into images or vice versa)
• privacy masking of annotated regions by resolution degradation (export annotation result after enabling 'apply_bbox_mosaic' parameter in darklabel.yml)
• windows only (32/64 bits system)

How to use (프로그램 사용법)

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

Mouse: Left(create box), Right(cancel latest)

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

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

Ctrl+DoubleClick: select/deselect box trajectory

*box trajectory: linked boxes over frames with the same ID and label

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

Ctrl+Arrow: scroll zoomed window

Ctrl+MouseWheel: zoom in/out

Ctrl+Mouse: scroll zoomed window

Enter key: apply tracking (newly created boxes only)

F1 key: show this help

Ctrl+'s': save gt

Remark (2020.7.9)

그동안 프로그램이 이유없이 죽는다는 댓글들이 종종 있었는데, 원인을 모르다가 최근에야 UI delay를 없애기 위해 도입했던 thread 처리에 문제가 있었음을 알게 되었습니다. 이번 DarkLabel 2.0에서는 대부분  문제를 제거했지만 혹시 남은 문제가 발견되면 피드백 바랍니다.

Version History

* DarkLabel 2.0 (2020.06.29)

- support machine learning formats: xml(pascalvoc/imagenet), txt(darknet yolo)

- support user-defined data formats (data formats can be defined in 'darklabel.yml')

- correct program stability problem (bug-fix related to unexpected program exit)

- add user-configurable hotkeys (it can be modified in 'darklabel.yml')

- labeling by tracking is now applied only to newly created boxes (keep the old boxes)

- lots of minor revision to enhance user convenience and program stability

* DarkLabel 1.3 (2018.03.31)

- 프로그램의 완성도를 높임 (ui, 반응속도, 안정성, 에러체크, 미세한 기능들, ...)

- trajectory 단위로 박스 선택/삭제/label수정 가능

- label(class)과 id를 분리해서 저장/로드할 수 있는 데이터 포맷 추가

* DarkLabel 1.2 (2018.02.19)

- 심각한 버그 수정: 숫자를 label로 사용할 경우 gt 데이터 로드시 오류 현상 수정

- interpolation을 이용한 labeling 기능 추가 (본문의 프로그램 사용법 참조)

- 개체 ID 자동부여 및 auto labeling 기능 추가 (본문의 프로그램 사용법 참조)

- 비디오내 프레임 이동시(navigation) GUI 반응성 개선

* DarkLabel 1.1 (2017.09.06)

- 작업결과를 동영상/이미지로 저장할 수 있는 기능 추가

* DarkLabel 1.0 (2017.07.18)

- labeling 기능 추가, tracker의 성능 및 UI 반응성 개선, 최신 비디오코덱 지원

- 프로그램 이름을 GT_Extractor에서 DarkLabel로 변경

* GT_Extractor 2.3 (2016.09.29)

- 버그 수정 (이미지 리스트에서 GT 파일 저장/불러올 때 오류 현상)

* GT_Extractor 2.2 (2016.08.26)

- 지원 비디오 포맷 추가 (avi, mpg, mp4, wmv, ...)

* GT_Extractor 2.1 (2013.08.12)

- 비디오 뿐만 아니라 이미지 목록에 대해서도 편집 가능

* GT_Extractor 2.0 (2013.01.15)

- 복수개의 대상 설정 및 추적 기능

* GT_Extractor 1.0 (2013.01.08)

- 이미지 당 하나의 대상만 설정할 수 있음

by 다크 프로그래머