3. Basic Operations

3.1. Start server

To start ReNomTAG, please use the following command in your working directory .


The application will use port 8080 by default. You can change the application port number with the following option.

# Run on port 8080
renom_tag --port 8080

Next, type the following URL into your web browser.


The public directory will be loaded and the following screen will be displayed.


3.2. Select Dataset

After starting the application, select the dataset for tagging from the list on the left. If the list is not displayed, click the icon in the upper left to access the list and select your dataset. This icon can be used to switch between datasets at any time.


3.3. Select Tagging Mode

ReNomTAG provides modes for creating object detection tags (bounding boxes), semantic segmentation labels (pixel-level annotations), and classification labels (image-level class labels).

Please select the mode by clicking on the corresponding mode name in the upper right.


3.3.1. Filter images

You can filter the images to be shown.

  • All : Show all images.
  • Need Review : Show images marked neither OK nor NG.
  • No Tags : Show images with no tags.
  • OK : Show images marked as OK by admin user.
  • NG : Show images marked as NG by admin user.

3.3.2. Add tags or labels to images

Please refer to “4: How to tag” for an explanation of how to apply tags or labels to images.

3.3.3. Add comments to images

You can also add comments to images. Users in normal mode can view comments but they cannot edit or add them.


3.4. Admin mode

ReNomTAG has two modes of operation, normal mode (default) and Admin mode. Admin mode has all functions found in normal mode as well as the following functions.

  • Add/delete class tags.
  • Mark tagged images as OK or NG .

3.4.1. Enter admin mode

To enter admin mode, please add admin to the URL as shown below.


The title of the page should change to Admin .


3.4.2. Add new class tags

If you are in admin mode, you can add new class tags. To do this, type the new class tag name into the form shown below.

Next, click the Add New Tag button.

You can also add a shortcut key. The shortcut key can be changed in either admin or normal mode.


3.4.3. Delete class tags

If you are in admin mode, you can also delete existing class tags. To do this, click the Delete Tag List button shown in red below.

Next, select the individual tags you would like to delete, and click Delete .


3.4.4. Apply marks to images

Admin mode also provides a marking function. You can mark tagged images as OK or NG .

To apply a mark, please click the OK or NG button.


After clicking the save button, the mark will be saved.

3.4.5. Return to normal mode

To return to normal mode, please remove admin from the URL.

3.5. Use ReNomTAG with multiple users

You can add multiple user directories under the public folder and then choose which directory you would like to work on.


The image above represents the following directory structure. There are 4 user directories (Alice, Bob, user1 and user2).

working_directory # Current Working directory
    └── public
        ├── Alice
        │   ├── dataset
        │   │   ├── image1.jpg
        │   │   ├── ...
        │   │   └── imageN.jpg
        │   └── label
        │       ├── detection
        │       ├── segmentation
        │       └── classification
        ├── Bob
        │   ├── dataset
        │   │   ├── image_car1.jpg
        │   │   ├── ...
        │   │   └── image_carN.jpg
        │   └── label
        │       ├── detection
        │       ├── segmentation
        │       └── classification
        ├── user1
        │   ├── dataset
        │   │   ├── image_person1.jpg
        │   │   ├── ...
        │   │   └── image_personN.jpg
        │   └── label
        │       ├── detection
        │       ├── segmentation
        │       └── classification
        └── user2
            ├── dataset
            │   ├── image_bird1.jpg
            │   └── image_bird2.jpg
            └── label
                ├── detection
                ├── segmentation
                └── classification

You can access and work in any user directory. The data in each directory is not shared with other directories.


The user-separated directories are recognised by ReNomTAG if they contain the dataset and label sub-directories.

3.6. Supported Browsers

ReNomTAG currently supports Google Chrome. In some instances, default shortcut keys for Google Chrome may conflict with ReNomTAG shortcut keys. Please disable the browser shortcut key in order to use the corresponding shortcut in ReNomTAG.