Skip to content

stephanecharette/DarkMark

Repository files navigation

What is DarkMark?

DarkMark and DarkHelp demo

DarkMark is a C++ GUI tool used to annotate images for use in neural networks. It was written specifically to be used with the Darknet neural network framework, and has several features tailored for use with Darknet and YOLO.

DarkMark editor window with annotated image of a dog

When you first launch DarkMark, you can specify a Darknet-style neural network to load with the selected project. DarkMark uses that neural network to assist you in marking up more images.

DarkMark launcher

Several different review capabilities exist to quickly review all the annotations and highlight some common errors.

DarkMark review window

Once ready, DarkMark can also be used to generate all of the Darknet and YOLO (or other) configuration files to train a new neural network. This includes the modifications needed to the .cfg file, as well as the .data, training and validation .txt files. DarkMark will also create some shell scripts to start the training and copy the necessary files between computers.

Darknet configuration

License

DarkMark is open source and published using the GNU GPL v3 license. See license.txt for details.

How to Build DarkMark

Extremely simple easy-to-follow tutorial on how to build Darknet, DarkHelp, and DarkMark:

DarkHelp build tutorial

DarkMark requires both Darknet and DarkHelp to build.

Once Darknet and DarkHelp have been built and installed, run the following commands to build DarkMark on Ubuntu:

sudo apt-get install build-essential libopencv-dev libx11-dev libfreetype6-dev libxrandr-dev libxinerama-dev libxcursor-dev libmagic-dev libpoppler-cpp-dev
cd ~/src
git clone https://github.com/stephanecharette/DarkMark.git
cd DarkMark
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j4 package
sudo dpkg -i darkmark*.deb

If you are using WSL2, Docker, or a Linux distro that does not come with the default fonts typically found on Ubuntu, you'll also need to install this:

sudo apt-get install fonts-liberation

Doxygen Output

The official DarkMark documentation and web site is at https://www.ccoderun.ca/darkmark/.

Some links to specific useful pages: