Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



7 Commits

Repository files navigation

multilingual TVRetrieval

mTVR: Multilingual Moment Retrieval in Videos, ACL 2021

Jie Lei, Tamara L. Berg, Mohit Bansal

We introduce MTVR, a large-scale multilingual video moment retrieval dataset, containing 218K English and Chinese queries from 21.8K TV show video clips. The dataset is collected by extending the popular TVR dataset (in English) with paired Chinese queries and subtitles. Compared to existing moment retrieval datasets, MTVR is multilingual, larger, and comes with diverse annotations. We further propose mXML, a multilingual moment retrieval model that learns and operates on data from both languages, via encoder parameter sharing and language neighborhood constraints. We demonstrate the effectiveness of mXML on the newly collected MTVR dataset, where mXML outperforms strong monolingual baselines while using fewer parameters. In addition, we also provide detailed dataset analyses and model ablations.


Getting started


  1. Clone this repository
git clone
cd mTVRetrieval
  1. Prepare feature files

Download mtvr_feature.tar.gz (24GB). After downloading the feature file, extract it to the project directory:

tar -xf path/to/mtvr_features.tar.gz -C .

You should be able to see mtvr_features under your project root directory. It contains video features (ResNet, I3D) and text features (subtitle and query, from RoBERTa). Please refer the TVR repo for details on feature extraction.

  1. Install dependencies.
# 1, create conda environment
conda create -n mtvr python=3.7 -y
conda activate mtvr
# 2, install PyTorch 
conda install pytorch torchvision -c pytorch
conda activate mtvr 
pip install easydict tqdm tensorboard
pip install h5py==2.9.0
  1. Add project root to PYTHONPATH

Note that you need to do this each time you start a new session.

Training and Inference

  1. mXML training
bash baselines/mxml/scripts/ 

Training using the above config will stop at around epoch 60, around 1 day with a single 2080Ti GPU. On val set, for VCMR R@1, IoU=0.7, you should be able to get ~2.4 for Chinese and ~2.9 for English. The resulting model and config will be saved at a dir: baselines/mxml/results/tvr-video_sub-*.

  1. mXML inference

After training, you can inference using the saved model on val or test_public set:

bash baselines/mxml/scripts/ MODEL_DIR_NAME SPLIT_NAME

MODEL_DIR_NAME is the name of the dir containing the saved model, e.g., tvr-video_sub-*. SPLIT_NAME could be val or test_public. By default, this code evaluates all the 3 tasks (VCMR, SVMR, VR), you can change this behavior by appending option, e.g. --tasks VCMR VR where only VCMR and VR are evaluated. The generated predictions will be saved at the same dir as the model, you can evaluate the predictions by following the instructions here Evaluation and Submission.

Evaluation and Submission

We only release ground-truth for train and val splits, to get results on test-public split, please submit your results follow the instructions here: standalone_eval/


If you find this code useful for your research, please cite our paper:

  title={mTVR: Multilingual Moment Retrieval in Videos},
  author={Lei, Jie and Berg, Tamara L and Bansal, Mohit},


This research is supported by grants and awards from NSF, DARPA and ARO. This code is built upon TVRetrieval.


jielei [at]


[ACL 2021] mTVR: Multilingual Video Moment Retrieval






No releases published


No packages published