# Media Tagger - User's Guide

[TOC]

## Quick Start

### Download link
[media_tagger 1.9.1 Installer](https://medicam-public.s3.us-west-2.amazonaws.com/software/media_tagger/media_tagger_1.9.1_setup.exe) for Windows 10, 64-bit.

### User Interfaces

1. App name and version
2. `Import`button
3. `Open Folder` button
4. the current working folder/zip file
5. List images in the working folder/zip file
6. `Export` button: To export the working files
7. Image file name
8. `Refresh` button: Clean up all the tags
9. `Snapshot` button: Take a snapshot of the annotated image
10. Labels (types of annotations)
11. Annotations

## What's New
### Version 1.9.1
#### Features
1. Import the zip file, which the app exported.
2. Delete individual annotation.
3. Show the corresponding tag in the picture when mouse moves in tag button.
4. The newly created tags, which have the same label, will have their unique name.

#### Bug fixes
1. Fix scroll bar move to the top when image selected error.
## Q&A

### How to select an image to add tags?

1. Click on the `Open Folder` button to select your working folder first:

2. Select an image from the list:

3. Depending on what you are going to annotate, select the proper label from the list:

4. Use your mouse to draw a tag:

:::info
:bulb: **Hint**: The app will record the points of the path you drawed
:::

### How to find the tag in picture?
1. Move the mouse on the tag button
2. The corresponding tag will show in the picture

### How to import annotated files?
1. Click Import button
2. Select the zip file you exported early
:::warning
:bulb: **Hint**: Depend on the size of imported file it may take a few seconds
:::

### How to delete individual annotation?

1. Select the corresopnd tag
2. Click Delete button

### How to clean tags?
For now, the only way to cancel the tag is to click the refresh button, which would clean up all the tags.
:::warning
:bulb: **Hint**: This function will clean all the tags in the picture.
:::

### How to export and share tagged images?
1. Click on the `Save` button:

2. Select the destination folder:

3. Click `Export`. Check the zip file which should contain images folder, which have tagged image in it, and data files (labels.json & pages.json):
Files inside the images folder

4. Share tagged image in the folder with your colleagues.

<!-- ### How to show/hide and remove tags?

1. From the tags list, click on the tags to show/hide each of them:

2. `Delete` button will appear when mouse hover-over a tag, click on the `Delete` button to remove the tag:
 -->

<!-- ### How to view colleague's annotations on an image?

1. When you receive an exported folder from your colleague, you can just launch the Media Tagger App to open the shared folder. You should see the images list with a popup says there are tagged images:
 -->

### How to save an image with annotations?

1. Click on the `Snapshot` button, and select a place to save the snapshop image: