An open source annotation and labeling tool for image and video assets.
VoTT helps facilitate an end-to-end machine learning pipeline:
VoTT can be installed as a native application or run from source. VoTT is also available as a stand-alone Web application and can be used in any modern Web browser.
VoTT is available for Windows, Linux and OSX. Download the appropriate platform package/installer from GitHub Releases.
v2 releases will be prefixed by
VoTT requires NodeJS (>= 10.x, Dubnium) and NPM
git clone https://github.com/Microsoft/VoTT.git cd VoTT npm ci npm start
When running locally with
npm, both the electron and the browser versions of the application will start. One major difference is that the electron version can access the local file system.
Using a modern Web browser, VoTT can be loaded from: https://vott.z22.web.core.windows.net
As noted above, the Web version of VoTT cannot access the local file system; all assets must be imported/exported through a Cloud project.
VoTT V2 is a refactor and refresh of the original Electron-based application. As the usage and demand for VoTT grew,
V2 was started as an initiative to improve and make VoTT more extensible and maintainable. In addition,
V2 uses more modern development frameworks and patterns (React, Redux) and is authored in TypeScript.
A number of code quality practices have been adopted, including:
V2 efforts are on the master branch
V1 will be on the v1 branch. There will not be any fixes or updates.
1.x releases can still be found under GitHub Releases.
There is support for converting a V1 project into V2 format. Upon opening the JSON file, a window will pop up to confirm that the app should convert the project before redirecting to the editor screen. In this process, a
.vott file will be generated in the same project directory, which may be used as the main project file going forward. We recommend backing up the V1 project file before converting the project.
VoTT is a 'Bring Your Own Data' (BYOD) application. In VoTT, connections are used to configure and manage source (the assets to label) and target (the location to which labels should be exported).
Connections can be set up and shared across projects. They use an extensible provider model, so new source/target providers can easily be added.
Currently, VoTT supports:
To create a new connection, click the
New Connections (plug) icon, in the left hand navigation bar:
Labeling workflows in VoTT revolve around projects - a collection of configurations and settings that persist.
Projects define source and target connections, and project metadata - including tags to be used when labeling source assets.
As mentioned above, all projects require a source and target connection:
Project settings can be modified after a project has been created, by clicking on the
Project Setting (slider) icon in the left hand navigation bar. Project metrics, such as Visited Assets, Tagged Assets, and Average Tags Per Asset can also be viewed on this screen.
Some project settings can include sensitive values, such as API keys or other shared secrets. Each project will generate a security token that can be used to encrypt/decrypt sensitive project settings.
Security tokens can be found in
Application Settings by clicking the gear icon in the lower corner of the left hand navigation bar.
NOTE: Project files can be shared among multiple people. In order to share sensitive project settings, all parties must have/use the same security token.
The token name and key must match in order for sensitive values to be successfully decrypted.
When a project is created or opened, the main tag editor window opens. The tag editor consists of three main parts:
Selecting an image or video on the left will load that image in the main tag editor. Regions can then be drawn on the loaded asset and a tag can be applied.
As desired, repeat this process for any additional assets.
Labeling a video is much like labeling a series of images. When a video is selected from the left, it will begin automatically playing, and there are several controls on the player, as seen here:
In addition to the normal video playback controls, there are two extra pairs of buttons.
On the left, there are the previous and next frame buttons. Clicking these will pause the video, and move to the next appropriate frame as determined by the project settings. For example, if the project settings have a frame extraction rate of 1, these buttons will cause the video to be moved back or forward 1 second, while if the frame extraction rate is 10, the video will be moved back or forward a tenth of a second.
On the right, there are the previous and next tagged frame buttons. Clicking these will pause the video and move to the next or previous frame that has a previously tagged region on it, if a tagged frame exists.
Colored lines will also be visible along the video's timeline. These indicate the video frames that have already been visited. A yellow line denotes a frame that has been visited only, while a green line denotes a frame that has been both visited and tagged. The colored lines can be clicked for quick navigation to the indicated frame.
The timeline can also be used to manually scrub through the video to an arbitrary point, though the project settings for frame extraction rate are always obeyed. Pausing the video will move to the closest frame according to this project setting. This way, a very low frame extraction rate, such as 1 frame per second, can be set for sections of the video known to contain few taggable items, and a much higher frame extraction rate, such as 30 frames per second, to allow fine-grained control.
Tagging and drawing regions is not possible while the video is playing.
Once assets have been labeled, they can be exported into a variety of formats:
In addition, users may choose to export
Click on the
Export (arrow) icon in the left hand navigation. Select the appropriate export provider and which assets to export. The percentage separated into testing and training sets can be adjusted here too.
VoTT allows a number of keyboard shortcuts to make it easier to keep one hand on the mouse while tagging. It allows most common shortcuts:
Hotkeys of 1 through 0 are assigned to the first ten tags. These can be reordered by using the up/down arrow icons in in the tag editor pane.
A tag can be locked for repeated tagging using the lock icon at the top of the tag editor pane. Tags can also be locked by combining Ctrl or Cmd and the tag hotkey, i.e.
Ctrl+2 would lock the second tag in the list.
In addition, the editor page has some special shortcuts to select tagging tools:
VOTT allows you to fine tune the bounding boxes using the arrow keys in a few different ways. While a region is selected:
The slide viewer can be navigated from the keyboard as follows:
When the video playback bar is present, it allows the following shortcuts to select frames:
For more details on github/web releases and versions -- please review our release process document
To build VoTT executable using command:
npm run release
For details on packaging executable for the release -- please review our PACKAGING.md
VoTT was originally developed by the Commercial Software Engineering (CSE) group at Microsoft in Israel.
V2 is developed by the CSE group at Microsoft in Redmond, Washington.
There are many ways to contribute to VoTT -- please review our contribution guidelines.