Install Vatic on Mac

Vatic is an image and video label software.

This is the tutorial for installing Vatic on your Mac. An online JS version of Vatic can be found here: https://dbolkensteyn.github.io/vatic.js/

Reference:

https://glentimemaker.github.io/Install-and-Use-Vatic-Annotation-Tool/

https://github.com/cvondrick/vatic (Offcial)

Following steps are tested on Mac OS. For windows system, you may need to install some command lines and add them to PATH.

String <???***???> should be replaced by your own address/filename.


1.Install Docker

Install Docker from https://www.docker.com/

Register, Login, Start Docker.

2.Creat Local Folder

Creat a folder named “data”. Put videos inside, then creat a folder named “frames” inside the folder “data”.

Open terminal, cd to your “data”‘s parent folder. Do following:

1
2
DATA_DIR=`pwd`/data/
mkdir -p $DATA_DIR

3.Start Vatic Server, MySQL and Apache

1
2
3
docker run -it -p 8080:80 -v $DATA_DIR:/home/vagrant/vagrant_data jldowns/vatic-docker-contrib:0.1

/home/vagrant/start_services.sh

Then cd to the vatic path:

1
cd /home/vagrant/vatic

4.Extract frames from video

1
turkic extract /home/vagrant/vagrant_data/<???video_name.mp4???> /home/vagrant/vagrant_data/frames/

Now you can use turkic command to operate your videos and labels.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
~/vatic# turkic                                              
compensate Pay workers
delete Deletes an already imported video
donation Report status on donations
dump Dumps the tracking data
email Email a worker
extract Decompresses an entire video into frames
find Provides a URL to fix annotations during vetting
formatframes Formats existing frames
invalidate Invalidates and rewspawn tasks
list List all videos loaded
load Imports a set of video frames
publish Launch work
sample Samples the performance by worker
setup Setup the application
status Report job status
visualize Highlights a video sequence
workers Manage the workers

More turkic command on offcial website.

5.Load & Publish

1
turkic load <???Job ID???> /home/vagrant/vagrant_data/frames/ <???LabelName1 LabelName2 LabelName3..???> --offline

6.Reopen Closed Vatic:

Reopen your Docker then cd to your folder path:

1
2
3
4
5
DATA_DIR=`pwd`/data/
mkdir -p $DATA_DIR
docker run -it -p 8080:80 -v $DATA_DIR:/home/vagrant/vagrant_data jldowns/vatic-docker-contrib:0.1
/home/vagrant/start_services.sh
cd /home/vagrant/vatic