Fast • Stable • Cross-Platform • Open Source
✨ Enhanced version of LabelImg with bug fixes & new features ✨
⭐ If you find this useful, please give it a star on GitHub! ⭐
This is a custom enhanced version of LabelImg — an open-source graphical image annotation tool — with major bug fixes and full compatibility on Windows, Linux, and macOS.
We’ve also introduced a Template RectBox Feature allowing you to apply the same bounding box to all images in a directory for faster annotation.
I have actively contributed to this open-source project by fixing critical issues in the Windows application and improving existing features, making the tool more stable, user-friendly, and efficient across platforms.
This project is originally based on LabelImg by:
- Tzutalin (2015–Present)
- Bryan Russell, Antonio Torralba, William T. Freeman (MIT CSAIL, 2013)
Enhanced, maintained, and improved by Sarath Chandiran in 2025.
- 🆕 Template RectBox – Save a bounding box template and apply it to all images in the directory.
- 🎯 Hotkeys for Templates
- Ctrl+T → Apply Template
- Ctrl+Shift+T → Unselect Template
- 🛠 Fixed all known LabelImg bugs (stable on Windows, Linux, macOS)
- 📦 Better Windows Compatibility – No more crashes or PyQt5 resource issues.
|
Figure 1: Draw your Bounding Box and Add Your Label |
|
Figure 2: Right Click on the bounded box and click 'Use Template for all' |
|
Figure 3: Click Next Image, The Template RectBox will be applied. |
|
Figure 4: You can adjust based on your needs |
# Clone the repository
git clone https://github.com/SARATH062005/labelimg.git
# Navigate into the project folder
cd labelimg# Install system dependencies
sudo apt update && sudo apt install -y \
git make python3-pip python3-venv pyqt5-dev-tools python3-pyqt5 python3-pyqt5.qtwebengine
# Clone LabelImg repo
git clone https://github.com/HumanSignal/labelImg.git
cd labelImg
# (Optional but recommended) Create a virtual environment
python3 -m venv venv
source venv/bin/activate
# Upgrade pip and install requirements
pip install --upgrade pip
pip install -r requirements/requirements-linux-python3.txt
# Build Qt resources
make qt5py3
# Run LabelImg (open GUI only)
python3 labelImg.py# Install dependencies via Homebrew
brew install qt # Installs qt-5.x.x
brew install libxml2
# OR using pip
pip3 install pyqt5 lxml
# Build and run
make qt5py3
python3 labelImg.py
python3 labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]# Open cmd and go to the LabelImg directory
pyrcc4 -o libs/resources.py resources.qrc
# For PyQt5
pyrcc5 -o libs/resources.py resources.qrc
python labelImg.py #----------This is prefered-------
python labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]# Open Anaconda Prompt and go to the LabelImg directory
conda install pyqt=5
conda install -c anaconda lxml
pyrcc5 -o libs/resources.py resources.qrc
python labelImg.py
python labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]| Key | Action |
|---|---|
| Ctrl + S | Save |
| Ctrl + T | Apply Template RectBox |
| Ctrl + Shift + T | Unselect Template |
| W | Create a RectBox |
| D | Next Image |
| A | Previous Image |
| Delete | Delete Selected Shape |
| Ctrl + Z | Undo |
| Ctrl + Shift + Z | Redo |
| Space | Verify Image |
MIT License
Copyright (c) 2025 Sarath Chandiran
Modifications and maintenance by Sarath Chandiran
Based on LabelImg by Tzutalin, Bryan Russell, Antonio Torralba, William T. Freeman
Permission is hereby granted, free of charge, to any person obtaining a copy...
We welcome contributions!
- Fork the project 🍴
- Create your feature branch 🌱
- Commit your changes 💡
- Push to your branch 🚀
- Open a Pull Request 🎯
- Author: Sarath Chandiran
- Email: [email protected]
- GitHub: @SARATH062005